> ## 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. # Delete an account number > 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. **`v2`** ยท Base URL `https://api.fintoc.com/v2` ## OpenAPI ````yaml reference/pacioli-api.json DELETE /account_numbers/{id} openapi: 3.1.0 info: title: Fintoc API version: v2026-02-01 servers: - url: https://api.fintoc.com/v2 security: [] paths: /account_numbers/{id}: delete: tags: - Account numbers summary: Delete an account number description: >- 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. operationId: account-numbers-delete parameters: - name: id in: path required: true schema: type: string description: Unique identifier of the account number to delete. responses: '200': description: The deleted account number. content: application/json: examples: account_number_deleted: value: id: acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN object: account_number account_id: acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA created_at: '2026-03-01T12:00:00.000Z' deleted_at: '2026-03-02T12:00:00.000Z' description: Payouts CLABE is_root: false last_transfer_at: null metadata: invoice_id: '12345' mode: test number: '646180111800000000' options: min_amount: 1000 max_amount: 1000000 status: deleted updated_at: '2026-03-02T12:00:00.000Z' schema: $ref: '#/components/schemas/account_number' '400': description: The account number is a root account number and cannot be deleted. content: application/json: examples: root_account_number: value: error: code: invalid_params message: >- You cannot modify 'status' for Root Account Number: acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN schema: $ref: '#/components/schemas/error_object' '401': description: Invalid or missing API key. content: application/json: examples: invalid_api_key: value: error: type: authentication_error code: invalid_api_key message: 'Invalid API Key: invalid-*oken' schema: $ref: '#/components/schemas/error_object' '403': description: Account numbers are available only for Mexico organizations. content: application/json: examples: account_numbers_not_available: value: error: code: invalid_account_number message: >- Unable to delete account number acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN. Action not available in your region schema: $ref: '#/components/schemas/error_object' '404': description: No account number with the given ID exists in your organization. content: application/json: examples: not_found: value: error: code: missing_resource message: >- Account Number not found: acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN schema: $ref: '#/components/schemas/error_object' '409': description: The account number is blocked and cannot be deleted. content: application/json: examples: blocked_account_number: value: error: code: blocked_account_number message: >- Account number acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN has been blocked. Contact soporte@fintoc.com for more information schema: $ref: '#/components/schemas/error_object' security: - api_key: [] components: schemas: account_number: type: object properties: id: type: string description: Unique identifier of the account number. example: acno_2daFu0zqqDtZGJaSi2TGI2Mm1nN object: const: account_number description: Type of the object. Always `account_number`. account_id: type: string description: Identifier of the account this number belongs to. example: acc_2hQ9vBmKpR7xLtZ3sWn1fJ4dGcA created_at: type: string format: date-time description: Time the account number was created, as an ISO 8601 datetime in UTC. example: '2026-03-01T12:00:00.000Z' deleted_at: type: - string - 'null' description: >- Time the account number was deleted, as an ISO 8601 datetime in UTC, or `null` when not deleted. example: null description: type: - string - 'null' description: >- Free-text description of the account number, or `null` when none is set. example: Payouts CLABE is_root: type: boolean description: Whether this account number is the account's default. example: false last_transfer_at: type: - string - 'null' description: >- Time of the last transfer received, as an ISO 8601 datetime in UTC, or `null` when no transfer has been received. example: null metadata: type: object description: Set of key-value pairs attached to the account number. example: invoice_id: '12345' mode: type: string enum: - live - test description: Whether the account number holds `live` or `test` data. example: test number: type: string description: >- Account number that receives inbound transfers. In Mexico, the 18-digit standardized Mexican bank account number (CLABE); in Chile, the bank account number. example: '646180111800000000' options: type: object description: Inbound transfer constraints for this account number. properties: min_amount: type: - integer - 'null' description: Minimum inbound amount, in the smallest currency unit. example: 1000 max_amount: type: - integer - 'null' description: Maximum inbound amount, in the smallest currency unit. example: 1000000 required: - min_amount - max_amount status: type: string enum: - enabled - disabled - blocked - deleted description: >- 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`). example: enabled updated_at: type: string format: date-time description: >- Time the account number was last updated, as an ISO 8601 datetime in UTC. example: '2026-03-01T12:00:00.000Z' required: - id - object - account_id - created_at - deleted_at - description - is_root - last_transfer_at - metadata - mode - number - options - status - updated_at error_object: type: object properties: error: type: object description: Details of the error that caused the request to fail. properties: code: type: string description: >- Machine-readable code identifying the specific error, for example `invalid_request`. example: invalid_request doc_url: type: string description: >- URL of a documentation page with more details about the error. Not returned by every error. example: https://docs.fintoc.com/reference/errors message: type: string description: Human-readable message describing the error. example: 'Missing required param: account_id' param: type: - string - 'null' description: >- Name of the request parameter that caused the error. Not returned by every error. example: account_id type: type: string description: >- Category of the error, for example `invalid_request_error` or `authentication_error`. Not returned by every error. example: invalid_request_error required: - code - message required: - error securitySchemes: api_key: type: apiKey name: Authorization in: header ````