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

Autorizaciones

Authorization
string
header
requerido

Parámetros de consulta

entity_id
string

Identifier of the entity whose accounts are returned. If omitted, returns only the accounts of your root entity.

status
enum<string>

Status of the accounts to return. One of active, blocked, closed.

Opciones disponibles:
active,
blocked,
closed
starting_after
string

Cursor for pagination. Use the ID of the last account on the current page to fetch the next page.

Ejemplo:

"acc_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"

ending_before
string

Cursor for pagination. Use the ID of the first account on the current page to fetch the previous page.

Ejemplo:

"acc_2rNxBkOrlHoOYsZTyQYhA0o8Ek0"

limit
integer

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

Ejemplo:

50

Respuesta

List of accounts for the current mode.

id
string
requerido

Unique identifier of the account.

Ejemplo:

"acc_2daFu0zqqDtZGJaSi2TGI2Mm1nN"

object
any
requerido

Type of the object. Always account.

available_balance
integer
requerido

Available balance of the account, in the smallest currency unit. For MXN the smallest unit is the centavo; for CLP it is the peso, which has no minor unit.

Ejemplo:

1050000

currency
enum<string>
requerido

ISO 4217 currency code of the account. One of CLP, MXN.

Opciones disponibles:
CLP,
MXN
Ejemplo:

"MXN"

description
string | null
requerido

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

Ejemplo:

"Main collection account"

entity
object
requerido

Owner entity of the account.

is_root
boolean
requerido

Whether this account is the organization's root account.

Ejemplo:

true

mode
enum<string>
requerido

Whether the account holds live or test data.

Opciones disponibles:
live,
test
Ejemplo:

"test"

root_account_number
string
requerido

Default account number of the account. In Mexico, the 18-digit standardized bank account number (CLABE); in Chile, the bank account number.

Ejemplo:

"646180111800000000"

root_account_number_id
string
requerido

Identifier of the default account number.

Ejemplo:

"acno_2fJkRm7tBvQxNzYpLc5WsHaDfT3"

status
enum<string>
requerido

Status of the account. One of active, blocked, closed.

Opciones disponibles:
active,
blocked,
closed
Ejemplo:

"active"