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

# Manage your Account Numbers

> Identify and delete inactive Fintoc Account Numbers so your organization keeps room in its quota as your integration grows in Mexico and other markets.

Identify and delete inactive Account Numbers to free quota as your integration grows.

## Check your Account Number usage

Your organization has a quota of 1,000,000 Account Numbers by default. In Mexico, an Account Number is a standardized Mexican bank account number (CLABE). Every active Account Number occupies one slot, whether it receives payments or not. Deleting an Account Number frees its slot immediately.

## Find inactive Account Numbers

Every Account Number tracks the timestamp of its last inbound transfer in the `last_transfer_at` field. An Account Number that has never received a transfer has `last_transfer_at` set to `null`.

Use the `no_transfers_since` filter on `GET /v2/account_numbers` to find Account Numbers with no transfer activity since a given date. The filter returns Account Numbers that have never received a transfer or received their last transfer before the given date.

```bash theme={null}
curl --request GET \
     --url 'https://api.fintoc.com/v2/account_numbers?no_transfers_since=2025-12-01' \
     --header 'Authorization: sk_test_jKaHdEa3mfmP0D105H' \
     --header 'accept: application/json'
```

```javascript theme={null}
const accountNumbers = await fintoc.v2.accountNumbers.list({
  no_transfers_since: "2025-12-01",
});
```

```python theme={null}
account_numbers = client.v2.account_numbers.list(
  no_transfers_since="2025-12-01"
)
```

```json theme={null}
{
  "data": [
    {
      "id": "acno_test_a1b2c3d4e5f6",
      "object": "account_number",
      "number": "000000000000000000",
      "is_root": false,
      "last_transfer_at": null
    }
  ]
}
```

## Delete an Account Number

Permanently delete an Account Number you no longer need with `DELETE /v2/account_numbers/{id}`. Unlike disabling an Account Number, deletion cannot be undone.

Deleting an Account Number starts a cooldown period during which no organization can use or reassign the Account Number. After the cooldown period, Fintoc may reassign the Account Number to a different organization when that organization creates a new Account Number.

You cannot delete root Account Numbers (`is_root: true`) or blocked Account Numbers.

```bash theme={null}
curl --request DELETE \
     --url https://api.fintoc.com/v2/account_numbers/acno_test_a1b2c3d4e5f6 \
     --header 'Authorization: sk_test_jKaHdEa3mfmP0D105H' \
     --header 'accept: application/json'
```

```javascript theme={null}
await fintoc.v2.accountNumbers.delete("acno_test_a1b2c3d4e5f6");
```

```python theme={null}
client.v2.account_numbers.delete("acno_test_a1b2c3d4e5f6")
```

```json theme={null}
{
  "id": "acno_test_a1b2c3d4e5f6",
  "object": "account_number",
  "number": "000000000000000000",
  "is_root": false,
  "status": "deleted"
}
```

### What happens after deletion

Deleting an Account Number triggers four changes:

1. Fintoc rejects inbound transfers. Fintoc returns payments sent to the deleted Account Number to the sender. This behavior applies to Mexico's Sistema de Pagos Electrónicos Interbancarios (SPEI) rail and Chile's Transferencia Electrónica de Fondos (TEF) rail.
2. Deletion frees quota. Your organization's Account Number count decreases, so you can create new Account Numbers.
3. Fintoc recycles the Account Number. After a cooldown period, Fintoc adds the Account Number to a pool and may reassign the Account Number to any account, including accounts that belong to other organizations.
4. Fintoc sends the `account_number.deleted` event to your configured webhook endpoints.

### Disable vs delete

Both actions stop inbound transfers, but they differ in whether you can reverse them and whether they free the Account Number and its quota:

| Behavior                           | Disable                           | Delete   |
| ---------------------------------- | --------------------------------- | -------- |
| **Reversible**                     | Yes                               | No       |
| **Inbound transfers**              | Rejected                          | Rejected |
| **Frees Account Number for reuse** | No, Account Number stays reserved | Yes      |
| **Frees Account Number quota**     | No                                | Yes      |

To temporarily stop receiving transfers on an Account Number, [disable the Account Number](/guides/transfers/inbound-transfers/add-logic-to-clabes) instead.

## Test the integration

Confirm the full flow in `test` mode before deleting any Account Number in `live` mode:

1. Create a test Account Number, or choose an existing one with `last_transfer_at` set to `null`.
2. Send the `DELETE /v2/account_numbers/{id}` request with your `sk_test_` key and confirm the response returns the Account Number with `"status": "deleted"`.
3. Confirm the `account_number.deleted` event arrives at your configured webhook endpoint.