curl --request GET \
--url https://api.fintoc.com/v2/account_numbers \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v2/account_numbers"
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/account_numbers', 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/account_numbers",
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/account_numbers"
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/account_numbers")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/account_numbers")
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": "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"
}
]{
"error": {
"code": "invalid_date",
"message": "must be a valid date",
"param": "no_transfers_since"
}
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}List account numbers
Lists the account numbers of your organization in the live or test mode of the API key used. Filter by account_id and no_transfers_since. The list is paginated. Use the starting_after, ending_before, and limit query parameters to move through the list. The Link response header carries the URLs to navigate the paginated list.
curl --request GET \
--url https://api.fintoc.com/v2/account_numbers \
--header 'Authorization: <api-key>'import requests
url = "https://api.fintoc.com/v2/account_numbers"
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/account_numbers', 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/account_numbers",
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/account_numbers"
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/account_numbers")
.header("Authorization", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fintoc.com/v2/account_numbers")
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": "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"
}
]{
"error": {
"code": "invalid_date",
"message": "must be a valid date",
"param": "no_transfers_since"
}
}{
"error": {
"type": "authentication_error",
"code": "invalid_api_key",
"message": "Invalid API Key: invalid-*oken"
}
}Autorizaciones
Parámetros de consulta
Identifier of the account whose account numbers are returned.
Account numbers whose last inbound transfer is earlier than the provided date, plus account numbers that never received an inbound transfer. Use an ISO 8601 date, such as 2026-07-28. This filter only applies to Mexico account numbers.
"2026-07-28"
Cursor that fetches the previous page of account numbers. Use the ID of the first account number from the current page.
"acno_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"
Maximum number of account numbers to return per page. Ranges from 1 to 300. Defaults to 30.
50
Cursor that fetches the next page of account numbers. Use the ID of the last account number from the current page.
"acno_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"
Respuesta
List of account numbers for the current mode.
Unique identifier of the account number.
"acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN"
Type of the object. Always account_number.
Identifier of the account this number belongs to.
"acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA"
Time the account number was created, as an ISO 8601 datetime in UTC.
"2026-03-01T12:00:00.000Z"
Time the account number was deleted, as an ISO 8601 datetime in UTC, or null when not deleted.
null
Free-text description of the account number, or null when none is set.
"Payouts CLABE"
Whether this account number is the account's default.
false
Time of the last transfer received, as an ISO 8601 datetime in UTC, or null when no transfer has been received.
null
Set of key-value pairs attached to the account number.
{ "invoice_id": "12345" }
Whether the account number holds live or test data.
live, test "test"
Account number that receives inbound transfers. In Mexico, the 18-digit standardized Mexican bank account number (CLABE); in Chile, the bank account number.
"646180111800000004"
Inbound transfer amount limits for this account number. Currently available for Mexico account numbers only.
Show child attributes
Show child attributes
Current state of the account number. One of enabled (can receive inbound transfers), disabled (you turned off inbound transfers), blocked (Fintoc blocked inbound transfers), or deleted (removed; see deleted_at).
enabled, disabled, blocked, deleted "enabled"
Time the account number was last updated, as an ISO 8601 datetime in UTC.
"2026-03-01T12:00:00.000Z"
¿Esta página le ayudó?