Saltar al contenido principal
GET
List account numbers
v2 · Base URL https://api.fintoc.com/v2

Autorizaciones

Authorization
string
header
requerido

Parámetros de consulta

account_id
string

Identifier of the account whose account numbers are returned.

ending_before
string

Cursor that fetches the previous page of account numbers. Use the ID of the first account number from the current page.

Ejemplo:

"acno_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"

limit
integer

Maximum number of account numbers to return per page. Ranges from 1 to 300. Defaults to 30.

Ejemplo:

50

starting_after
string

Cursor that fetches the next page of account numbers. Use the ID of the last account number from the current page.

Ejemplo:

"acno_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"

Respuesta

List of account numbers for the current mode.

id
string
requerido

Unique identifier of the account number.

Ejemplo:

"acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN"

object
any
requerido

Type of the object. Always account_number.

account_id
string
requerido

Identifier of the account this number belongs to.

Ejemplo:

"acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA"

created_at
string<date-time>
requerido

Time the account number was created, as an ISO 8601 datetime in UTC.

Ejemplo:

"2026-03-01T12:00:00.000Z"

deleted_at
string | null
requerido

Time the account number was deleted, as an ISO 8601 datetime in UTC, or null when not deleted.

Ejemplo:

null

description
string | null
requerido

Free-text description of the account number, or null when none is set.

Ejemplo:

"Payouts CLABE"

is_root
boolean
requerido

Whether this account number is the account's default.

Ejemplo:

false

last_transfer_at
string | null
requerido

Time of the last transfer received, as an ISO 8601 datetime in UTC, or null when no transfer has been received.

Ejemplo:

null

metadata
object
requerido

Set of key-value pairs attached to the account number.

Ejemplo:
mode
enum<string>
requerido

Whether the account number holds live or test data.

Opciones disponibles:
live,
test
Ejemplo:

"test"

number
string
requerido

Account number that receives inbound transfers. In Mexico, the 18-digit standardized Mexican bank account number (CLABE); in Chile, the bank account number.

Ejemplo:

"646180111800000000"

options
object
requerido

Inbound transfer constraints for this account number.

status
enum<string>
requerido

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).

Opciones disponibles:
enabled,
disabled,
blocked,
deleted
Ejemplo:

"enabled"

updated_at
string<date-time>
requerido

Time the account number was last updated, as an ISO 8601 datetime in UTC.

Ejemplo:

"2026-03-01T12:00:00.000Z"