Skip to main content
GET
List account numbers

Autorizaciones

Authorization
string
header
requerido

Parámetros de consulta

account_id
string

Identifier of the account whose account numbers are returned.

no_transfers_since
string

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.

Ejemplo:

"2026-07-28"

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:

"646180111800000004"

options
object
requerido

Inbound transfer amount limits for this account number. Currently available for Mexico account numbers only.

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"