> ## 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 number object

> Account numbers enable you to receive and track realtime Inbound Transfers using the Transfer API.

## The Account Number object

An `AccountNumber` represents a bank account number tied to one of your accounts that can receive inbound transfers. In Mexico, it corresponds to a standardized Mexican bank account number (CLABE). Fintoc returns an `AccountNumber` object when you create one for an account, or when you list or retrieve the account numbers you own.

```json theme={null}
{
  "id": "acno_Kasf91034gj1AD",
  "object": "account_number",
  "account_id": "acc_Lq7dP901xZgA2B",
  "created_at": "2024-03-01T20:09:42.949787176Z",
  "deleted_at": null,
  "description": "My payins",
  "is_root": false,
  "last_transfer_at": "2026-03-15T14:22:01.000Z",
  "metadata": {
    "order_id": "12343212"
  },
  "mode": "test",
  "number": "000000000000000000",
  "options": {
    "max_amount": 400,
    "min_amount": 300
  },
  "status": "enabled",
  "updated_at": "2024-03-01T20:09:42.949787176Z"
}
```

| Field              | Type   | Description                                                                                                                                                                                   |
| :----------------- | :----- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`               | string | Unique identifier for the account number.                                                                                                                                                     |
| `object`           | string | The type of the object, which is always `account_number`.                                                                                                                                     |
| `account_id`       | string | Account the Account Number points to.                                                                                                                                                         |
| `created_at`       | string | Timestamp when the account number was created (in ISO 8601 format).                                                                                                                           |
| `deleted_at`       | string | Timestamp when the account number was deleted. `null` if the account number has not been deleted.                                                                                             |
| `description`      | string | Label to identify this Account Number. Up to 40 characters.                                                                                                                                   |
| `is_root`          | bool   | Indicates if the Account Number is the main Account Number of the Account. Root Account Numbers appear as the sender Account Number for Outbound Transfers.                                   |
| `last_transfer_at` | string | Timestamp of the last inbound transfer received by this account number. `null` if no inbound transfer has ever been received.                                                                 |
| `metadata`         | object | Optional key-value pairs associated with this account number.                                                                                                                                 |
| `mode`             | string | Mode of the API (`test` or `live`).                                                                                                                                                           |
| `number`           | string | Account number that receives inbound transfers. In Mexico, this value is a standardized Mexican bank account number (CLABE).                                                                  |
| `options`          | object | Additional configurations for Account Numbers.                                                                                                                                                |
| `status`           | string | Account number status. One of `enabled`, `disabled`, `blocked`, or `deleted`. Fintoc automatically returns inbound transfers directed to `disabled`, `blocked`, or `deleted` account numbers. |
| `updated_at`       | string | Timestamp when the account number was last updated (in ISO 8601 format).                                                                                                                      |

### The Options object (within the Account Number object)

The `Options` object holds the minimum and maximum amount thresholds that filter inbound `Transfers`. It appears in the `options` field of the `AccountNumber` object.

| Field        | Type    | Description                                                                                                                                                                                                                                                        |
| :----------- | :------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `max_amount` | integer | Maximum amount accepted for inbound transfers. Transfers exceeding this threshold are automatically rejected. Amount is specified in the base currency unit for the account's country: centavos for Mexico, pesos for Chile. Must be a positive integer or `null`. |
| `min_amount` | integer | Minimum amount accepted for inbound transfers. Transfers below this threshold are automatically rejected. Amount is specified in the base currency unit for the account's country: centavos for Mexico, pesos for Chile. Must be a positive integer or `null`.     |