> ## 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 allow you to keep track of your available balance and execute outbound Transfers

## 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.

```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": "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](https://www.iso.org/iso-4217-currency-codes.html).                |
| `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.                                                                                                             |