---
title: "List bank accounts"
method: GET
path: "/bank_accounts"
tags: ["Bank Accounts"]
---

# List bank accounts

`GET /bank_accounts`

## Query parameters

- `employee_id` string
- `contractor_id` string
- `business_entity_id` string
- `expand` string[]

## Response `200`

OK

- object
  - `object` string — The type of the object in Nmbr (`"list"`).
  - `data` object[]
    - `id` string — The unique identifier of the object in Nmbr.
    - `object` string — The type of the object in Nmbr (`"bank_account"`).
    - `data` BankAccount
      - `business_entity` object — The Business Entity that owns this bank account. Present only for Business Entity bank accounts.
        - `id` string — The unique identifier of the object in Nmbr.
        - `object` string — The type of the object in Nmbr (`"business_entity"`).
      - `institution_number` string — The 3-digit bank institution number.
      - `institution_name` string, nullable — The name of the banking institution matching the institution number, or `null` if the number is not recognized. Always the English name; see `institution_name_translated` for the value in the request's locale.
      - `institution_name_translations` object, nullable
        - `en` string, nullable
        - `fr` string, nullable
      - `institution_name_translated` string — The translation of the `institution_name` property for the request locale. Computed using the values in `institution_name` and `institution_name_translations` and the value of the request's `Accept-Language` header.
      - `transit_number` string — The 5-digit bank transit number.
      - `transit_address` string, nullable — The address of the branch matching the institution and transit numbers, or `null` if the pair is not recognized.
      - `account_number_last_3` string, nullable — The last 3 digits of the bank account number.
      - `is_primary` boolean — Whether this is the primary bank account for its owner.
      - `is_deletable` boolean — Whether this bank account can be deleted.
      - `warnings` object, nullable — A collection of data validation warnings for this bank account. Warnings indicate incomplete or potentially incorrect data, such as an unrecognized institution or transit number.
        - `object` string, nullable
        - `data` object, nullable
      - `is_pad_signed` boolean — Whether a PAD agreement has been signed. Only present for Business Entity bank accounts.
      - `pad_signer_name` string, nullable — The name of the person who signed the PAD agreement. Only applicable to Business Entity bank accounts.
      - `pad_signer_email` string, nullable — The email address of the PAD agreement signer. Only applicable to Business Entity bank accounts.
      - `pad_signer_title` string, nullable — The title or role of the PAD agreement signer. Only applicable to Business Entity bank accounts.
      - `pad_signed_at` string, dateTime, nullable — The date and time the PAD agreement was signed. Only applicable to Business Entity bank accounts.
      - `pad_file` unknown
      - `created_at` string, dateTime — The date and time the object was created in Nmbr.
      - `updated_at` string, dateTime — The date and time the object was last updated in Nmbr.

---

[API](https://skmtc.net/nmbr/apis/nmbr-api.md) · [All operations](https://skmtc.net/nmbr/apis/nmbr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nmbr/nmbr-api/revisions/667d6f31841e/schema)