---
title: "List Bank Accounts"
method: GET
path: "/customers/{customer_id}/bank_accounts"
tags: ["Bank Accounts"]
---

# List Bank Accounts

`GET /customers/{customer_id}/bank_accounts`

## Request

- Base URL: `https://api.inscribe.ai/api/v2`
- URL: `https://api.inscribe.ai/api/v2/customers/{customer_id}/bank_accounts`
- Auth: API key in header `Authorization`

Returns a list of bank accounts for a customer. The list is sorted by creation date, with the most recently created bank accounts appearing first.

## Path parameters

- `customer_id` string, uuid, required

## Query parameters

- `size` integer, required
- `cursor` string, uuid
- `include_unreconciled_documents` boolean

## Response `200`

Returns back a list of Bank Account objects.

- ListBankAccounts
  - `data` BankAccountData[]: A map with a data property that contains an array of bank accounts. Each entry in the array is a separate bank account object.
    - `id` string, uuid: Unique identifier for the object.
    - `account_number` string, nullable: The account number of the bank account.
    - `account_type` 'PERSONAL' | 'BUSINESS', nullable: The type of the bank account.
    - `account_name` string, nullable: The name of the bank account.
    - `end_date` string, date, nullable: The end date of the bank account in the format yyyy-MM-dd.
    - `start_date` string, date, nullable: The start date of the bank account in the format yyyy-MM-dd.
    - `guid` string, nullable: An identifier for the bank account submitted by the data provider.
    - `institution_name` string, nullable: The name of the bank.
  - `pagination` object
    - `cursor` string, uuid: A cursor for use in pagination. This cursor is to be used in the next request's cursor parameter to request the next set of bank accounts.
  - `metadata` MetadataTransactionsAccounts: Additional data which provides context about Inscribe's Credit Insights response.
    - `customer_contains_low_trust_score_documents` boolean: This value will be set to True if the customer contains any documents under a trust score threshold of 50. Else, this will be set to False.
    - `included_data_sources` object: Lists all documents and open banking data which were used to create the Inscribe Credit Insights.
      - `documents` object[]
        - `document_id` string, uuid
      - `open_banking` object[]
        - `open_banking_data_id` string, uuid
    - `excluded_data_sources` object: Lists all documents and open banking data which were excluded from the Inscribe Credit Insights. Documents can be excluded if they are duplicate documents, or when the include_unreconciled_documents query parameter is set to False.
      - `documents` object[]
        - `document_id` string, uuid
        - `exclusion_reason` string, string
      - `open_banking` object[]
        - `open_banking_data_id` string, uuid
    - `query_parameters` object: Lists the query parameters which were used in the original endpoint request.

## Other responses

- `400`: You have provided incorrect data.
- `403`: You do not have permission to access this resource.
- `404`: The specified resource was not found.
- `429`: Too many requests. The request has been rate limited. For more information, visit our [documentation on rate limiting](https://docs.inscribe.ai/docs/are-the-endpoints-rate-limited).

---

[API](https://skmtc.dev/inscribe/apis/core-resources.md) - [All operations](https://skmtc.dev/inscribe/apis/core-resources/llms.txt) - [OpenAPI document](https://skmtc.dev/inscribe/apis/core-resources/revisions/dc2155c2504f?raw)
