---
title: "Look up bank account details"
method: POST
path: "/bank_accounts/lookup"
tags: ["Bank Accounts"]
---

# Look up bank account details

`POST /bank_accounts/lookup`

## Request body

- object
  - `institution_number` string — The institution number to look up. Optional.
  - `transit_number` string — The transit number to look up. Optional.
  - `account_number` string — The account number to validate. Optional.

## 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_lookup"`).
  - `data` BankAccountLookup
    - `warnings` object, nullable — A collection of advisory warnings for the submitted account, in the same shape as the warnings on a bank account.
      - `object` string, nullable
      - `data` object, nullable
    - `institution_name` string, nullable — The name of the banking institution matching the submitted institution number, or `null` if it was not provided or 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_address` string, nullable — The address of the branch matching the submitted institution and transit numbers, or `null` if either was not provided or the pair is not recognized.

---

[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/01cd9c45a923/schema)