Skip to main content
GET
List account numbers
v2 · Base URL https://api.fintoc.com/v2

Authorizations

Authorization
string
header
required

Query Parameters

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.

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:

"646180111800000000"

options
object
required

Inbound transfer constraints for this account number.

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"