> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Account object

> Accounts let you track your available balance and send outbound transfers.

## 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](https://www.iso.org/iso-4217-currency-codes.html) 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](#the-entity-object-within-the-account-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:

```json Account Object theme={null}
{
  "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.                                                                                                                                 |