---
title: "List financial accounts"
method: GET
path: "/v1/financial_accounts"
tags: ["Financial Account"]
---

# List financial accounts

`GET /v1/financial_accounts`

Retrieve information on your financial accounts including routing and account number.

## Query parameters

- `account_token` string, uuid
- `business_account_token` string, uuid
- `type` 'ISSUING' | 'OPERATING' | 'RESERVE' | 'SECURITY' | 'EARLY_DIRECT_DEPOSIT_FLOAT'

## Response `200`

OK

- FinancialAccountsResponse
  - `data` FinancialAccountResponse[], required
    - `token` string, uuid, required — Globally unique identifier for the account
    - `created` string, date-time, required
    - `updated` string, date-time, required
    - `type` union, required
      - 'ISSUING' | 'RESERVE' | 'OPERATING' | 'CHARGED_OFF_FEES' | 'CHARGED_OFF_INTEREST' | 'CHARGED_OFF_PRINCIPAL' | 'SECURITY' | 'PROGRAM_RECEIVABLES' | 'COLLECTION' | 'PROGRAM_BANK_ACCOUNTS_PAYABLE' | 'EARLY_DIRECT_DEPOSIT_FLOAT' | 'PROVISIONAL_CREDIT_ACCOUNT' — Type of instance financial account
      - 'ISSUING' | 'OPERATING' — Type of account financial account
    - `routing_number` string, nullable
    - `account_number` string, nullable
    - `nickname` string, nullable, required
    - `account_token` string, uuid, nullable, required
    - `status` 'OPEN' | 'CLOSED' | 'SUSPENDED' | 'PENDING', required — Status of the financial account
    - `substatus` 'CHARGED_OFF_DELINQUENT' | 'CHARGED_OFF_FRAUD' | 'END_USER_REQUEST' | 'BANK_REQUEST' | 'DELINQUENT' | 'INTEREST_AND_FEES_PAUSED', required — Substatus for the financial account
    - `user_defined_status` string, nullable, required — User-defined status for the financial account
    - `is_for_benefit_of` boolean, required — Whether financial account is for the benefit of another entity
    - `credit_configuration` FinancialAccountCreditConfig, nullable, required
      - `credit_limit` integer, nullable, required
      - `external_bank_account_token` string, uuid, nullable, required
      - `credit_product_token` string, nullable, required — Globally unique identifier for the credit product
      - `tier` string, nullable, required — Tier assigned to the financial account
      - `auto_collection_configuration` AutoCollectionConfigurationResponse, required
        - `auto_collection_enabled` boolean, required — If auto collection is enabled for this account
  - `has_more` boolean, required

## Other responses

- `400` — A parameter in the query given in the request does not match the valid queries for the endpoint.
- `401` — | | | |---|---| | User has not been authenticated | Invalid or missing API key | | API key is not active | The API key used is no longer active | | Could not find API key | The API key provided is not associated with any user | | Please provide API key in Authorization header | The Authorization header is not in the request | | Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly | | Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at [lithic.com/contact](https://lithic.com/contact) | | Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege | Reach out at [lithic.com/contact](https://lithic.com/contact) |
- `404` — The specified resource was not found.
- `422` — Unprocessable entity.
- `429` — Client has exceeded the number of allowed requests in a given time period. | | | |---|---| | Rate limited, too many requests per second | User has exceeded their per second rate limit | | Rate limited, reached daily limit | User has exceeded their daily rate limit | | Rate limited, too many keys tried | One IP has queried too many different API keys |

---

[API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/revisions/53ab5d4e2adb/schema)