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

# List Bank Accounts

`GET /print-mail/v1/bank_accounts`

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

---

[API](https://skmtc.net/postgrid/apis/postgrid-address-verification-api.md) · [All operations](https://skmtc.net/postgrid/apis/postgrid-address-verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/postgrid/postgrid-address-verification-api/revisions/537d2bbc624a/schema)