curl --request GET \
--url https://api.fintoc.com/v2/transfers \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v2/transfers"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.fintoc.com/v2/transfers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fintoc.com/v2/transfers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fintoc.com/v2/transfers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fintoc.com/v2/transfers")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/transfers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": "tr_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
"object": "transfer",
"account_number": {
"id": "acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
"object": "account_number",
"account_id": "acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"created_at": "2026-03-01T12:00:00.000Z",
"deleted_at": null,
"description": "Payouts CLABE",
"is_root": false,
"last_transfer_at": null,
"metadata": {
"invoice_id": "12345"
},
"mode": "test",
"number": "646180111800000004",
"options": {
"min_amount": 1000,
"max_amount": 1000000
},
"status": "enabled",
"updated_at": "2026-03-01T12:00:00.000Z"
},
"amount": 50000,
"comment": "Payout March",
"counterparty": {
"account_number": "132000000000000004",
"account_type": "clabe",
"email": null,
"holder_id": null,
"holder_name": "Test Customer 1",
"institution": {
"id": "40132",
"name": "MULTIVA BANCO",
"country": "mx"
}
},
"currency": "MXN",
"direction": "outbound",
"entity": {
"id": "ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9",
"holder_id": "000000000",
"holder_name": "Test Customer 1",
"is_root": true
},
"metadata": {
"test_key": "test_value"
},
"error_reason": null,
"mode": "test",
"post_date": null,
"receipt_url": null,
"reject_reason": null,
"reference_id": null,
"return_reason": null,
"reversed_at": null,
"failed_at": null,
"rejected_at": null,
"status": "succeeded",
"tracking_key": null,
"transaction_date": "2026-03-01T12:00:00.000Z"
}
]{
"error": {
"type": "invalid_request_error",
"code": "invalid_params",
"message": "Cannot use starting_after and ending_before params at the same time"
}
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}List transfers
Lists the transfers of your organization in the live or test mode of the API key used. Filter by account_id, account_number_id, direction, status, tracking_key, and transfer_batch_id, or by date range with since and until. The list is paginated. Use the starting_after, ending_before, and limit query parameters to page through it. The Link response header carries the URLs to navigate the pages.
curl --request GET \
--url https://api.fintoc.com/v2/transfers \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v2/transfers"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.fintoc.com/v2/transfers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fintoc.com/v2/transfers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.fintoc.com/v2/transfers"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.fintoc.com/v2/transfers")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/transfers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'
response = http.request(request)
puts response.read_body[
{
"id": "tr_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
"object": "transfer",
"account_number": {
"id": "acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
"object": "account_number",
"account_id": "acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA",
"created_at": "2026-03-01T12:00:00.000Z",
"deleted_at": null,
"description": "Payouts CLABE",
"is_root": false,
"last_transfer_at": null,
"metadata": {
"invoice_id": "12345"
},
"mode": "test",
"number": "646180111800000004",
"options": {
"min_amount": 1000,
"max_amount": 1000000
},
"status": "enabled",
"updated_at": "2026-03-01T12:00:00.000Z"
},
"amount": 50000,
"comment": "Payout March",
"counterparty": {
"account_number": "132000000000000004",
"account_type": "clabe",
"email": null,
"holder_id": null,
"holder_name": "Test Customer 1",
"institution": {
"id": "40132",
"name": "MULTIVA BANCO",
"country": "mx"
}
},
"currency": "MXN",
"direction": "outbound",
"entity": {
"id": "ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9",
"holder_id": "000000000",
"holder_name": "Test Customer 1",
"is_root": true
},
"metadata": {
"test_key": "test_value"
},
"error_reason": null,
"mode": "test",
"post_date": null,
"receipt_url": null,
"reject_reason": null,
"reference_id": null,
"return_reason": null,
"reversed_at": null,
"failed_at": null,
"rejected_at": null,
"status": "succeeded",
"tracking_key": null,
"transaction_date": "2026-03-01T12:00:00.000Z"
}
]{
"error": {
"type": "invalid_request_error",
"code": "invalid_params",
"message": "Cannot use starting_after and ending_before params at the same time"
}
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}Autorizaciones
Parámetros de consulta
Identifier of the account whose transfers are returned.
Identifier of the account number whose transfers are returned.
Direction of the transfers to return. One of inbound or outbound.
inbound, outbound Statuses to filter by. One or more of pending, succeeded, failed, returned, return_pending, rejected, reject_failed, partially_succeeded, reverse_pending, and reversed. Returns transfers whose status matches any of the values you provide. partially_succeeded, reverse_pending, and reversed are available for Chilean transfers only.
pending, succeeded, failed, returned, return_pending, rejected, reject_failed, partially_succeeded, reverse_pending, reversed Lower bound for the transaction date. Returns transfers with a transaction_date on or after this ISO 8601 datetime in UTC.
"2026-01-01T00:00:00Z"
Upper bound for the transaction date. Returns transfers with a transaction_date on or before this ISO 8601 datetime in UTC.
"2026-03-31T23:59:59Z"
Interbank tracking key (clave de rastreo) to filter by. Returns transfers whose tracking_key matches this value exactly. Available for Mexican transfers only.
"3843CP04202404102978240559"
Identifier of the transfer batch to filter by. Returns the transfers that belong to this batch.
"trbatch_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
Cursor that fetches the next page of transfers. Use the ID of the last transfer from the current page.
"tr_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"
Cursor that fetches the previous page of transfers. Use the ID of the first transfer from the current page.
"tr_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"
Maximum number of transfers to return per page. Ranges from 1 to 300. Defaults to 30.
50
Respuesta
List of transfers for the current mode.
Unique identifier of the transfer.
"tr_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
Type of the object. Always transfer.
Show child attributes
Show child attributes
Amount of the transfer, in the smallest currency unit. For MXN this is centavos; CLP has no minor unit.
50000
Comment shown to the counterparty, or null.
"Payout March"
Details of the counterparty of the transfer.
Show child attributes
Show child attributes
Currency of the transfer. One of CLP, MXN.
CLP, MXN "MXN"
Whether the transfer is inbound or outbound.
inbound, outbound "outbound"
Entity that owns the account involved in the transfer. For an inbound transfer this is the entity that received the money; for an outbound transfer, the entity that sent it.
Show child attributes
Show child attributes
Set of key-value pairs attached to the transfer.
{ "test_key": "test_value" }
Reason code for a failed transfer, or null. This field is available for Chilean transfers only. One of recipient_account_disabled_for_tef, recipient_institution_timeout, recipient_institution_unavailable, invalid_recipient_account, recipient_account_closed, invalid_recipient_holder_id, invalid_holder_id_account_relationship, account_type_not_enabled, recipient_account_not_found, product_account_not_enabled, recipient_account_credit_restricted, recipient_institution_amount_limit_exceeded, system_amount_limit_exceeded, and unknown.
recipient_account_disabled_for_tef, recipient_institution_timeout, recipient_institution_unavailable, invalid_recipient_account, recipient_account_closed, invalid_recipient_holder_id, invalid_holder_id_account_relationship, account_type_not_enabled, recipient_account_not_found, product_account_not_enabled, recipient_account_credit_restricted, recipient_institution_amount_limit_exceeded, system_amount_limit_exceeded, unknown, null null
Whether the transfer is live or test data.
live, test "test"
Time the transfer was posted, as an ISO 8601 datetime in UTC, or null.
null
URL of the transfer receipt, or null.
null
Reason code for a rejected transfer, or null. This field is available for Chilean transfers only. One of recipient_account_closed, recipient_account_credit_restricted, and unknown.
recipient_account_closed, recipient_account_credit_restricted, unknown, null null
Numeric reference shown in the counterparty statement in Mexico, or null.
null
Reason code when the transfer was returned, or null.
null
Time the transfer was reversed, as an ISO 8601 datetime in UTC, or null. This field is available for Chilean transfers only.
null
Time the transfer failed, as an ISO 8601 datetime in UTC, or null. This field is available for Chilean transfers only.
null
Time the transfer was rejected, as an ISO 8601 datetime in UTC, or null. This field is available for Chilean transfers only.
null
Lifecycle status of the transfer. One of pending (being processed), succeeded (settled), partially_succeeded (only part of the amount settled), rejected (rejected before settling), failed (could not be processed), returned (settled, then returned to the sender), return_pending (a return is in progress), reject_failed (the rejection could not be completed), reverse_pending (a reversal is in progress), or reversed (settled, then reversed). A Chilean transfer can move from succeeded to reverse_pending and then reversed when a payment network issue requires a reversal. partially_succeeded, reverse_pending, and reversed occur for Chilean transfers only.
pending, succeeded, failed, returned, return_pending, rejected, reject_failed, partially_succeeded, reverse_pending, reversed "succeeded"
Interbank tracking key (clave de rastreo) of the transfer, or null.
null
Time the transfer occurred, as an ISO 8601 datetime in UTC, or null.
"2026-03-01T12:00:00.000Z"
¿Esta página le ayudó?