---
title: "List payment accounts"
method: GET
path: "/payment_accounts"
tags: ["Payment Account"]
---

# List payment accounts

`GET /payment_accounts`

## Request

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

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

## Query parameters

- `before` string, nullable
- `after` string, nullable
- `limit` union
  - integer
  - string

## Headers

- `GoCardless-Version` string, required

## Response `200`

Successful response

- PaymentAccountMultiResourceResponse
  - `payment_accounts` PaymentAccount[]
    - `id` string: Unique identifier, beginning with "BA".
    - `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.
    - `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.
    - `links` PaymentAccountLinks
      - `creditor` string: ID of the [creditor](https://docs.gocardless.com/docs/api-reference/creditor) that owns this bank account.
    - `account_balance` integer: Current balance on a payment account in the lowest denomination for the currency (e.g. pence in GBP, cents in EUR). It is time-sensitive as it is ever changing.
  - `meta` PaymentAccountPaginationMeta: 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)