---
title: "List Accounts"
method: GET
path: "/accounts"
---

# List Accounts

`GET /accounts`

## 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.
- `entity_id` string — Filter Accounts for those belonging to the specified Entity.
- `informational_entity_id` string — Filter Accounts for those belonging to the specified Entity as informational.
- `program_id` string — Filter Accounts for those in a specific Program.
- `status.in` string[] — Filter Accounts for those with the specified status. For GET requests, this should be encoded as a comma-delimited string, such as `?in=one,two,three`.
- `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 List

- AccountList — A list of Account objects.
  - `data` Account[], required — The contents of the list.
    - `account_revenue_rate` string, nullable, required — The account revenue rate currently being earned on the account, as a string containing a decimal number. For example, a 1% account revenue rate would be represented as "0.01". Account revenue is a type of non-interest income accrued on the account.
    - `bank` 'core_bank' | 'first_internet_bank' | 'grasshopper_bank', required — The bank the Account is with.
    - `closed_at` string, date-time, nullable, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Account was closed.
    - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) time at which the Account was created.
    - `currency` 'USD', required — The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code for the Account currency.
    - `entity_id` string, required — The identifier for the Entity the Account belongs to.
    - `funding` 'loan' | 'deposits', required — Whether the Account is funded by a loan or by deposits.
    - `id` string, required — The Account 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).
    - `informational_entity_id` string, nullable, required — The identifier of an Entity that, while not owning the Account, is associated with its activity.
    - `interest_rate` string, required — The interest rate currently being earned on the account, as a string containing a decimal number. For example, a 1% interest rate would be represented as "0.01".
    - `loan` object, nullable, required — The Account's loan-related information, if the Account is a loan account.
      - `credit_limit` integer, required — The maximum amount of money that can be borrowed on the Account.
      - `grace_period_days` integer, required — The number of days after the statement date that the Account can be past due before being considered delinquent.
      - `maturity_date` string, date, nullable, required — The date on which the loan matures.
      - `statement_day_of_month` integer, required — The day of the month on which the loan statement is generated.
      - `statement_payment_type` 'balance' | 'interest_until_maturity', required — The type of payment for the loan.
    - `name` string, required — The name you choose for the Account.
    - `program_id` string, required — The identifier of the Program determining the compliance and commercial terms of this Account.
    - `status` 'closed' | 'open', required — The status of the Account.
    - `type` 'account', required — A constant representing the object's type. For this resource it will always be `account`.
  - `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)