---
title: "List creditor bank accounts"
method: GET
path: "/creditor_bank_accounts"
tags: ["Creditor Bank Account"]
---

# List creditor bank accounts

`GET /creditor_bank_accounts`

## Request

- Base URL: `https://api.gocardless.com`
- URL: `https://api.gocardless.com/creditor_bank_accounts`
- Auth: HTTP bearer

Returns a [cursor-paginated](https://docs.gocardless.com/docs/api-reference/data-conventions#cursor-pagination) list of your creditor bank accounts.

## Query parameters

- `before` string, nullable
- `after` string, nullable
- `limit` union
  - integer
  - string
- `created_at` object
  - `gt` string, date-time: Limit to records created after the specified date-time.
  - `lt` string, date-time: Limit to records created before the specified date-time.
  - `gte` string, date-time: Limit to records created on or after the specified date-time.
  - `lte` string, date-time: Limit to records created on or before the specified date-time.
- `creditor` string: Unique identifier, beginning with "CR".
- `enabled` union
  - 'true' | 'false'
  - boolean

## Headers

- `GoCardless-Version` string, required

## Response `200`

Successful response

- CreditorBankAccountMultiResourceResponse
  - `creditor_bank_accounts` CreditorBankAccount[]
    - `id` string: Unique identifier, beginning with "BA".
    - `created_at` string, date-time: Fixed [timestamp](https://docs.gocardless.com/docs/api-reference/data-conventions#dates-and-times), recording when this resource was created.
    - `account_holder_name` string: Name of the account holder, as known by the bank. Usually this is the same as the name stored with the linked [creditor](https://docs.gocardless.com/docs/api-reference/creditor). This field will be transliterated, upcased and truncated to 18 characters.
    - `account_number_ending` string, nullable: The last few digits of the account number. Currently 4 digits for NZD bank accounts and 2 digits for other currencies.
    - `account_type` 'savings' | 'checking', nullable: Bank account type. Required for USD-denominated bank accounts. Must not be provided for bank accounts in other currencies. See [local details](https://docs.gocardless.com/docs/api-reference/local-bank-details#united-states) for more information.
    - `country_code` string, nullable: [ISO 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements). Defaults to the country code of the `iban` if supplied, otherwise is required.
    - `currency` string, nullable: [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217#Active_codes) currency code. Currently "AUD", "CAD", "DKK", "EUR", "GBP", "NZD", "SEK" and "USD" are supported.
    - `bank_name` string, nullable: Name of bank, taken from the bank details.
    - `enabled` boolean: Boolean value showing whether the bank account is enabled or disabled.
    - `metadata` CustomerMetadata: Key-value store of custom data. Up to 3 keys are permitted, with key names up to 50 characters and values up to 500 characters.
    - `links` CreditorBankAccountLinks
      - `creditor` string: ID of the [creditor](https://docs.gocardless.com/docs/api-reference/creditor) that owns this bank account.
    - `verification_status` 'pending' | 'in_review' | 'successful' | 'could_not_verify': Verification status of the Bank Account. Can be one of `pending`, `in_review` or `successful`
  - `meta` CreditorBankAccountPaginationMeta: Cursor pagination information
    - `limit` integer, required
    - `cursors` object, required
      - `before` string, nullable, required: Cursor pointing to the end of the desired set.
      - `after` string, nullable, required: Cursor pointing to the start of the desired set.

## Other responses

- `400`: Bad Request
- `401`: Unauthorised
- `404`: Not found
- `422`: Validation Error
- `500`: Internal Error

---

[API](https://skmtc.dev/gocardless/apis/gocardless-api.md) - [All operations](https://skmtc.dev/gocardless/apis/gocardless-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gocardless/apis/gocardless-api/revisions/4dd3dae45364?raw)