---
title: "List Bank Accounts"
method: GET
path: "/print-mail/v1/bank_accounts"
tags: ["Bank Accounts"]
---

# List Bank Accounts

`GET /print-mail/v1/bank_accounts`

## Request

- Base URL: `https://api.postgrid.com`
- URL: `https://api.postgrid.com/print-mail/v1/bank_accounts`
- Auth: API key in header `X-API-Key`

Get a list of bank accounts.

Note that we do not return the complete account number or the signature image for security reasons.

## Query parameters

- `skip` integer
- `limit` integer
- `search` union
  - string
  - string: You can supply a structured search query instead of supplying unstructured text to any list endpoint help refine your search for a resource. For example, let's say you created a series of letters that all had `metadata: { campaignID: 'abc' }`. You could search for all those letters by passing in `{ "metadata.campaignID": "abc" }` into the `search` parameter. Note that this string must be valid JSON.

## Response `200`

The request has succeeded.

- BankAccountList
  - `object` 'list', required
  - `totalCount` integer, required
  - `skip` integer, required
  - `limit` integer, required
  - `data` BankAccount[], required
    - `object` 'bank_account', required: Always `bank_account`.
    - `bankName` string, required: The name of the bank.
    - `bankPrimaryLine` string: The primary address line of the bank.
    - `bankSecondaryLine` string: The secondary address line of the bank.
    - `bankCountryCode` 'CA' | 'US', required: Countries typically have different bank account formats and standards. These are the countries which PostGrid's bank accounts API supports.
    - `accountNumber` string, required: The account number of the bank account.
    - `routingNumber` string: The routing number of the bank account (for US).
    - `transitNumber` string: The transit number of the bank account (for CA).
    - `routeNumber` string: The route number of the bank account (for CA).
    - `caDesignationNumber` string: The designation number of the bank account (for CA).
    - `id` string, required: A unique ID prefixed with bank_account_
    - `description` string: An optional string describing this resource. Will be visible in the API and the dashboard.
    - `metadata` object: See the section on Metadata.
    - `live` boolean, required: `true` if this is a live mode resource else `false`.
    - `createdAt` string, date-time, required: The UTC time at which this resource was created.
    - `updatedAt` string, date-time, required: The UTC time at which this resource was last updated.
    - `signatureText` string: The signature text PostGrid uses to generate a signature for cheques created using this bank account. This is omitted if `signatureImage` is present.
    - `signatureImage` string, uri: A signed link to the signature image uploaded when this bank account was created. This is omitted if `signatureText` is present.

## Other responses

- `400`: The server could not understand the request due to invalid syntax.
- `401`: Access is unauthorized.
- `429`: Client error
- `500`: Server error

## Changes

- **2026-05-01** `c8fedcbd705e`: 3 warning, 2 info
  - added the new `internal_server_error` enum value to the `error/type` response property for the response status `500`
  - added the new `rate_limit_exceeded_error` enum value to the `error/type` response property for the response status `429`
  - added the new `validation_error` enum value to the `error/type` response property for the response status `400`
  - added `subschema #1, subschema #2` to the response body `anyOf` list for the response status `401`
  - …1 more

[Operation history](https://skmtc.dev/postgrid/apis/postgrid-address-verification-api/changes/print-mail/v1/bank_accounts/get.md)

---

[API](https://skmtc.dev/postgrid/apis/postgrid-address-verification-api.md) - [All operations](https://skmtc.dev/postgrid/apis/postgrid-address-verification-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postgrid/apis/postgrid-address-verification-api/revisions/537d2bbc624a?raw)