---
title: "Bank lookup by account identifier."
method: POST
path: "/v3/bank-lookup"
tags: ["Bank Lookup"]
---

# Bank lookup by account identifier.

`POST /v3/bank-lookup`

## Request

- Base URL: `https://api.truelayer-sandbox.com`
- URL: `https://api.truelayer-sandbox.com/v3/bank-lookup`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.truelayer.com/connect/token` scopes: `verification:bank_lookup`

Retrieve bank information (BIC and name) by providing an account identifier (IBAN or Sort Code + Account Number).

**Headers Required:**
Authorization (JWT) Token with bearer scheme format is required to make a call to Verification API.

## Headers

- `Authorization` string, bearer JWT, required

## Request body

- BankLookupRequest
  - `account_identifier` union, required: A unique scheme identifier for bank lookup.
    - Iban: The international bank account number.
      - `type` 'iban', required: The type of account identifier.
      - `iban` string, required: Valid International Bank Account Number (no spaces). Consists of a 2 letter country code, followed by 2 check digits, and then by up to 30 alphanumeric characters.
    - SortCodeAccountNumber: The sort code and account number.
      - `type` 'sort_code_account_number', required: The type of account identifier.
      - `sort_code` string, required: 6 digit sort code (no spaces or dashes).
      - `account_number` string, required: 8 digit account number.

## Response `200`

OK

- BankLookupResponse
  - `bic` string, required: Bank Identifier Code (BIC) of the bank
  - `name` string, required: Full name of the bank

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/truelayer/apis/verification-api.md) - [All operations](https://skmtc.dev/truelayer/apis/verification-api/llms.txt) - [OpenAPI document](https://skmtc.dev/truelayer/apis/verification-api/revisions/77da464b9281?raw)