Skip to main content
GET
List account numbers

Authorizations

Authorization
string
header
required

Query Parameters

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.

Example:

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

Example:

"acno_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"

limit
integer

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

Example:

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.

Example:

"acno_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"

Response

List of account numbers for the current mode.

id
string
required

Unique identifier of the account number.

Example:

"acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN"

object
any
required

Type of the object. Always account_number.

account_id
string
required

Identifier of the account this number belongs to.

Example:

"acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA"

created_at
string<date-time>
required

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

Example:

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

deleted_at
string | null
required

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

Example:

null

description
string | null
required

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

Example:

"Payouts CLABE"

is_root
boolean
required

Whether this account number is the account's default.

Example:

false

last_transfer_at
string | null
required

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

Example:

null

metadata
object
required

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

Example:
mode
enum<string>
required

Whether the account number holds live or test data.

Available options:
live,
test
Example:

"test"

number
string
required

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

Example:

"646180111800000004"

options
object
required

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

status
enum<string>
required

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

Available options:
enabled,
disabled,
blocked,
deleted
Example:

"enabled"

updated_at
string<date-time>
required

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

Example:

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