Account object

The Account object

An Account represents a balance held by an entity that you use to track available funds and send outbound transfers. You receive an Account object when you create one, and when you list or retrieve the accounts in your organization, including the root account that holds your initial Fintoc balance.

{
  "id": "acc_23JlasHas241",
  "object": "account",
  "available_balance": 23459183,
  "currency": "MXN",
  "description": "My root account",
  "entity": {
    "id": "ent_4324qwkalsds",
    "holder_id": "ND",
    "holder_name": "ACME Inc."
  },
  "is_root": true,
  "mode": "test",
  "root_account_number": "738969123456789120",
  "root_account_number_id": "acno_Kasf91034gj1AD",
  "status": "active"
}

Field	Type	Description
`id`	`string`	Unique identifier for the Account.
`object`	`string`	The type of the object, which is always `account`.
`available_balance`	`integer`	The balance available for outbound transfers in the account at a given time, in the smallest currency unit.
`currency`	`string`	The currency of the account balance in ISO 4217 format.
`description`	`string`	A description you can use to identify this account. Up to 40 characters.
`entity`	`object`	The entity the account belongs to.
`is_root`	`boolean`	If `true`, this account is the main account. Root accounts are created automatically and hold your initial Fintoc balance.
`mode`	`string`	The mode of the API, either `test` or `live`.
`root_account_number`	`string`	The number of the root account number related to this account.
`root_account_number_id`	`string`	The ID of the root account number related to this account.
`status`	`string`	The status of the account. One of `active`, `blocked`, or `closed`.

A blocked account cannot send transfers, and this status can be reversed to active. A closed account cannot receive or send transfers, and this status is irreversible.

The Entity object (within the Account object)

The Entity object identifies the legal holder that owns the account, and it appears in the entity field of the Account object.

Field	Type	Description
`id`	`string`	Unique identifier for the entity.
`holder_id`	`string`	The account owner's tax ID. In Chile, a Chilean tax ID (RUT). In Mexico, a Mexican tax ID (RFC) or unique population registry code (CURP).
`holder_name`	`string`	The name of the account owner.