Account object

The Account object

An Account represents funds held for an entity. You use an account to track available funds and send outbound transfers. You receive an Account object when you create, list, or retrieve an account. The account list includes the root account that holds your initial Fintoc balance. The following table describes the attributes of an Account object:

Field	Type	Description
`id`	`string`	Unique identifier for the `Account` object.
`object`	`string`	Identifier for the object type. Always `account`.
`available_balance`	`integer`	Balance available for outbound transfers, in the smallest currency unit.
`currency`	`string`	Three-letter ISO 4217 currency code for the account balance.
`description`	`string`	Text you can use to identify the account. Up to 40 characters.
`entity`	`object`	Legal holder that owns the account. See The `Entity` object.
`is_root`	`boolean`	If `true`, the account is the root account. Root accounts are created automatically and hold your initial Fintoc balance.
`mode`	`string`	API mode used for the account. One of `test` or `live`.
`root_account_number`	`string`	Number assigned to the associated root account.
`root_account_number_id`	`string`	Unique identifier for the associated root account number.
`status`	`string`	Current state of the account. One of `active`, `blocked`, or `closed`.

A blocked account cannot send transfers. You can change a blocked account back to active. A closed account cannot receive or send transfers. You cannot reverse the closed status. The following example shows a fully populated Account object:

Account Object

{
  "id": "acc_23JlasHas241",
  "object": "account",
  "available_balance": 23459183,
  "currency": "MXN",
  "description": "My root account",
  "entity": {
    "id": "ent_4324qwkalsds",
    "holder_id": "ND",
    "holder_name": "Test Entity 1"
  },
  "is_root": true,
  "mode": "test",
  "root_account_number": "000000000000000000",
  "root_account_number_id": "acno_Kasf91034gj1AD",
  "status": "active"
}

The Entity object (within the Account object)

The Entity object identifies the account’s legal holder. The Entity object appears in the entity field of the Account object. The following table describes the attributes of an Entity object:

Field	Type	Description
`id`	`string`	Unique identifier for the entity.
`holder_id`	`string`	Tax identifier for the account owner. Use a Chilean tax ID (RUT) in Chile. Use a Mexican tax ID (RFC) or Unique Population Registry Code (CURP) in Mexico.
`holder_name`	`string`	Name of the account owner.

Fintoc API

Main Resources

Payments API

Transfers API

Movements API

Direct Debit (Legacy)

Fiscal API

Account object

The Account object

The Entity object (within the Account object)

​The Account object

​The Entity object (within the Account object)

The Account object

The Entity object (within the Account object)