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

# Update an account number

`PATCH /account_numbers/{id}`

Updates the editable fields of an account number of your organization: `description`, `status`, `metadata`, and inbound `options`.

## Path parameters

- `id` string, required

## Request body

- object
  - `description` string — Free-text description of the account number.
  - `status` 'enabled' | 'disabled' — Status to apply to the account number. One of `enabled` (can receive inbound transfers) or `disabled` (cannot receive inbound transfers). You cannot set the `blocked` or `deleted` states through this endpoint.
  - `metadata` object — Set of key-value pairs you can attach to the account number for storing additional structured information.
  - `options` object — Inbound transfer constraints for this account number.
    - `min_amount` integer — Minimum inbound amount, in the smallest currency unit.
    - `max_amount` integer — Maximum inbound amount, in the smallest currency unit.

## Response `200`

The updated 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` — A parameter has an invalid value.
- `401` — Invalid or missing API key.
- `404` — No account number with the given ID exists in your organization.

---

[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)