---
title: "Delete an account number"
method: DELETE
path: "/account_numbers/{id}"
tags: ["Account numbers"]
---

# Delete an account number

`DELETE /account_numbers/{id}`

Deletes an account number of your organization. Available only for Mexico account numbers, which are standardized Mexican bank account numbers (CLABEs). You cannot delete the root account number. Returns the deleted account number. Deleting an account number that is already deleted is idempotent: the endpoint returns the account number again with its `deleted` status instead of an error. The endpoint returns `404 Not Found` only when no account number with the given ID exists. The underlying CLABE becomes available in the recycling pool 30 days after deletion, and Fintoc may reassign the CLABE to a different account or organization. Deletion is permanent and cannot be undone.

## Path parameters

- `id` string, required

## Response `200`

The deleted account number.

- AccountNumber
  - `id` string, required — Unique identifier of the account number.
  - `object` 'account_number', required — Type of the object. Always `account_number`.
  - `account_id` string, required — Identifier of the account this number belongs to.
  - `created_at` string, date-time, required — Time the account number was created, as an ISO 8601 datetime in UTC.
  - `deleted_at` string, nullable, required — Time the account number was deleted, as an ISO 8601 datetime in UTC, or `null` when not deleted.
  - `description` string, nullable, required — Free-text description of the account number, or `null` when none is set.
  - `is_root` boolean, required — Whether this account number is the account's default.
  - `last_transfer_at` string, nullable, required — Time of the last transfer received, as an ISO 8601 datetime in UTC, or `null` when no transfer has been received.
  - `metadata` object, required — Set of key-value pairs attached to the account number.
  - `mode` 'live' | 'test', required — Whether the account number holds `live` or `test` data.
  - `number` string, required — Account number that receives inbound transfers. In Mexico, the 18-digit standardized Mexican bank account number (CLABE); in Chile, the bank account number.
  - `options` object, required — Inbound transfer constraints for this account number.
    - `min_amount` integer, nullable, required — Minimum inbound amount, in the smallest currency unit.
    - `max_amount` integer, nullable, required — Maximum inbound amount, in the smallest currency unit.
  - `status` 'enabled' | 'disabled' | 'blocked' | 'deleted', required — Current state of the account number. One of `enabled` (can receive inbound transfers), `disabled` (you turned off inbound transfers), `blocked` (Fintoc blocked inbound transfers), or `deleted` (removed; see `deleted_at`).
  - `updated_at` string, date-time, required — Time the account number was last updated, as an ISO 8601 datetime in UTC.

## Other responses

- `400` — The account number is a root account number and cannot be deleted.
- `401` — Invalid or missing API key.
- `403` — Account numbers are available only for Mexico organizations.
- `404` — No account number with the given ID exists in your organization.
- `409` — The account number is blocked and cannot be deleted.

---

[API](https://skmtc.net/fintoc/apis/fintoc-api.md) · [All operations](https://skmtc.net/fintoc/apis/fintoc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fintoc/fintoc-api/versions/9dafa63688a3/schema)