> ## 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": "738969123456789120",
  "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 | A description you can use to easily identify this Account Number (40 chars max.).                                                                                                       |
| `is_root`          | bool   | Indicates if the Account Number is the main Account Number of the Account. Root Account Numbers will 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 | The account number (for Mexico: CLABE) of the sender.                                                                                                                                   |
| `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 will be 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 will be 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.     |