---
title: "List all Account Numbers"
method: GET
path: "/v1/account_number"
tags: ["Account Number"]
---

# List all Account Numbers

`GET /v1/account_number`

List all Account Numbers.

## Query parameters

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

## Response `200`

List of Account Numbers

- ListAccountNumber
  - `objects` AccountNumber[], required
    - `id` string — The ID of the retrieved Account Number.
    - `account_number` string — The account number.
    - `routing_number` string — The routing number.
    - `account_id` string — The ID of the Account object.
    - `client_customer_id` string — The ID of your customer.
    - `entity_id` string — The ID of your entity.
    - `status` 'active' | 'inactive' | 'canceled' | 'unassigned' — Account Number Status
    - `ach_controls` AchControls — ACH payment controls
      - `originator_id` string — The ID of the Originator object.
      - `incoming` IncomingAch — Incoming ACH payment controls
        - `accept_credit` boolean — Accept ACH credits
        - `accept_debit` boolean — Accept ACH debits
        - `counterparty_filter` 'accept_all' | 'reject_all' | 'allowlist_only' — Control mode for counterparty filtering
        - `counterparty_company_ids_allowlist` CompanyId[] — Allowed Company IDs when mode is allowlist_only
      - `outgoing` OutgoingAch — Outgoing ACH payment controls
        - `counterparty_filter` 'accept_all' | 'reject_all' | 'allowlist_only' — Control mode for counterparty filtering
        - `counterparty_account_numbers_allowlist` AllowedCounterpartyAccount[] — Allowed destinations when mode is allowlist_only
          - `type` 'us_domestic', required
          - `account_number` string, required
          - `routing_number` string, required
    - `wire_controls` WireControls — Wire payment controls
      - `incoming` IncomingWire — Incoming Wire payment controls
        - `counterparty_filter` 'accept_all' | 'reject_all' | 'allowlist_only' — Control mode for counterparty filtering
        - `counterparty_account_numbers_allowlist` AllowedCounterpartyAccount[] — Allowed destinations when mode is allowlist_only
          - `type` 'us_domestic', required
          - `account_number` string, required
          - `routing_number` string, required
      - `outgoing` OutgoingWire — Outgoing Wire payment controls
        - `counterparty_filter` 'accept_all' | 'reject_all' | 'allowlist_only' — Control mode for counterparty filtering
        - `counterparty_account_numbers_allowlist` AllowedCounterpartyAccount[] — Allowed destinations when mode is allowlist_only
          - `type` 'us_domestic', required
          - `account_number` string, required
          - `routing_number` string, required
      - `outgoing_international` OutgoingInternationalWire — Outgoing International Wire payment controls
        - `counterparty_filter` 'accept_all' | 'reject_all' | 'allowlist_only' — Control mode for counterparty filtering
        - `counterparty_international_account_numbers_allowlist` AllowedInternationalCounterpartyAccount[] — Allowed international destinations when mode is allowlist_only
          - `business_identifier_code` string, required — BIC (Business Identifier Code / SWIFT code)
          - `account_identifier` object, required — Account identifier for the international account
            - `type` 'IBAN' | 'account_number', required — Type of account identifier
            - `value` string, required — The account identifier value
    - `internal_transfer_controls` InternalTransferControls — Internal Transfer controls
      - `incoming` IncomingInternalTransfer — Controls for receiving internal transfers
        - `counterparty_filter` 'accept_all' | 'reject_all' | 'allowlist_only' — Control mode for counterparty filtering
        - `counterparty_account_number_ids_allowlist` AccountNumberID[] — Allowlist of account_number IDs that can send
      - `outgoing` OutgoingInternalTransfer — Controls for sending internal transfers
        - `counterparty_filter` 'accept_all' | 'reject_all' | 'allowlist_only' — Control mode for counterparty filtering
        - `counterparty_account_number_ids_allowlist` AccountNumberID[] — Allowlist of account_number IDs to send to
    - `instant_payment_controls` InstantPaymentControls — Instant Payment controls
      - `incoming` IncomingInstantPayment — Incoming Instant Payment controls
        - `counterparty_filter` 'accept_all' | 'reject_all' | 'allowlist_only' — Control mode for counterparty filtering
        - `counterparty_account_numbers_allowlist` AllowedUsDomesticCounterpartyAccount[] — Allowed destinations when mode is allowlist_only
          - `account_number` string, required
          - `routing_number` string, required
      - `outgoing` OutgoingInstantPayment — Outgoing Instant Payment controls
        - `counterparty_filter` 'accept_all' | 'reject_all' | 'allowlist_only' — Control mode for counterparty filtering
        - `counterparty_account_numbers_allowlist` AllowedUsDomesticCounterpartyAccount[] — Allowed destinations when mode is allowlist_only
          - `account_number` string, required
          - `routing_number` string, required
    - `metadata` Metadata — A set of key-value pairs that can be used to store additional information related to this object.
    - `created_at` string, date-time — The timestamp of creation in ISO-8601 format.
    - `updated_at` string, date-time — The timestamp of last update in ISO-8601 format.
  - `has_more` boolean, required — Indicates if there are more account numbers to retrieve.

---

[API](https://skmtc.net/lead/apis/lead-bank.md) · [All operations](https://skmtc.net/lead/apis/lead-bank/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lead/lead-bank/revisions/25c2a92d55e2/schema)