---
title: "Retrieve a bank account"
method: GET
path: "/bank_accounts/{bank_account}"
tags: ["Bank Accounts"]
---

# Retrieve a bank account

`GET /bank_accounts/{bank_account}`

## Path parameters

- `bank_account` string, required

## Query parameters

- `expand` string[]

## Response `200`

OK

- 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"`).
    - `name` string, nullable — An optional human-readable label for the bank account, such as "Main chequing". Useful for distinguishing accounts at the same institution.
    - `institution_number` string — The 3-digit bank institution number. An institution Nmbr does not hold raises a `bank_account_unrecognized_institution` warning rather than failing the request.
    - `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. A transit that is not a known branch of the given institution raises a `bank_account_unrecognized_transit` warning rather than failing the request.
    - `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.

## Changes

- **2026-08-25** `5eebdc91b9ef` — 1 info
  - added the optional property `data/allOf[subschema #1: Bank Account]/name` to the response with the `200` status
- **2026-08-19** `12dd3b52211d` — 1 info
  - added the optional property `data/anyOf[subschema #4: With business_entity expanded]/business_entity/data/accounting_settings/journal_entry_dimensions` to the response with the `200` status

[Change history](https://skmtc.dev/nmbr/apis/nmbr-api/changes/bank_accounts/:bank_account/get.md)

---

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