---
title: "List account numbers"
method: GET
path: "/account_numbers"
tags: ["Account numbers"]
---

# List account numbers

`GET /account_numbers`

Lists the account numbers of your organization in the `live` or `test` mode of the API key used. Filter by `account_id`. The list is paginated. Use the `starting_after`, `ending_before`, and `limit` query parameters to move through the list. The `Link` response header carries the URLs to navigate the paginated list.

## Query parameters

- `account_id` string
- `ending_before` string
- `limit` integer
- `starting_after` string

## Response `200`

List of account numbers for the current mode.

- 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

- `401` — Invalid or missing API key.

---

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