---
title: "List Account Numbers"
method: GET
path: "/account_numbers"
---

# List Account Numbers

`GET /account_numbers`

## Query parameters

- `cursor` string — Return the page of entries after this one.
- `limit` integer — Limit the size of the list that is returned. The default (and maximum) is 100 objects.
- `status.in` string[] — The status to retrieve Account Numbers for. For GET requests, this should be encoded as a comma-delimited string, such as `?in=one,two,three`.
- `ach_debit_status.in` string[] — The ACH Debit status to retrieve Account Numbers for. For GET requests, this should be encoded as a comma-delimited string, such as `?in=one,two,three`.
- `account_id` string — Filter Account Numbers to those belonging to the specified Account.
- `created_at.after` string, date-time — Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.before` string, date-time — Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_after` string, date-time — Return results on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `created_at.on_or_before` string, date-time — Return results on or before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.
- `idempotency_key` string — Filter records to the one with the specified `idempotency_key` you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).

## Response `200`

Account Number List

- AccountNumberList — A list of Account Number objects.
  - `data` AccountNumber[], required — The contents of the list.
    - `account_id` string, required — The identifier for the account this Account Number belongs to.
    - `account_number` string, required — The account number.
    - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Account Number was created.
    - `id` string, required — The Account Number identifier.
    - `idempotency_key` string, nullable, required — The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).
    - `inbound_ach` object, required — Properties related to how this Account Number handles inbound ACH transfers.
      - `debit_status` 'allowed' | 'blocked', required — Whether ACH debits are allowed against this Account Number. Note that they will still be declined if this is `allowed` if the Account Number is not active.
    - `inbound_checks` object, required — Properties related to how this Account Number should handle inbound check withdrawals.
      - `status` 'allowed' | 'check_transfers_only', required — How Increase should process checks with this account number printed on them.
    - `name` string, required — The name you choose for the Account Number.
    - `routing_number` string, required — The American Bankers' Association (ABA) Routing Transit Number (RTN).
    - `status` 'active' | 'disabled' | 'canceled', required — This indicates if payments can be made to the Account Number.
    - `type` 'account_number', required — A constant representing the object's type. For this resource it will always be `account_number`.
  - `next_cursor` string, nullable, required — A pointer to a place in the list. Pass this as the `cursor` parameter to retrieve the next page of results. If there are no more results, the value will be `null`.

## Other responses

- `4XX` — Error
- `5XX` — Error

---

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