---
title: "Verify account holder name."
method: POST
path: "/verification/v1/verify"
tags: ["Account Verification"]
---

# Verify account holder name.

`POST /verification/v1/verify`

## Request

- Base URL: `https://api.truelayer-sandbox.com`
- URL: `https://api.truelayer-sandbox.com/verification/v1/verify`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.truelayer.com/connect/token` scopes: `verification`

Verify supplied name with account holder's name.

**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

- NameVerificationRequest
  - `name` string, required: The name supplied by the client that needs to be matched with the account holder name at the bank. Sample Request Example: ``` { "name": "Jack Johnson" } ``` __Max length: 200 characters__.

## Response `200`

OK

- NameVerificationResponse
  - `verified` boolean: Indicates whether the name values (the name you provide, and the name on file at the bank) meet the `match_score` threshold. If the `match_score` is greater than the set threshold, `verified` will be `true`. If not, `verified` will be `false`. By default, this threshold is 54.
  - `account_holder_name` string: Account holder's name.
  - `match_score` integer: A score between 0 and 100 (inclusive) that indicates how closely the supplied name matches the name on the account. This value is used to determine whether the user's name is successfully `verified`.
  - `failure_description` string: The description returned when account is not verifiable, which explains why.
  - `failure_code` string: Failure code
  - `report` object[]
    - `verifiable` boolean: Indicates whether or not the account is verifiable.
    - `failure_description` string: Description returned when the account is not verifiable.
    - `failure_code` string: Failure code
    - `currency` string: The currency of the account. Can be GBP or EUR.
    - `provider_id` string: The ID associated with the bank.
    - `account_type` string: Type of the account returned by the bank.
    - `account_holders` object[]
      - `name` string: Array of names of account holders in the account
      - `verified` boolean: Indicates whether the name values (the name you provide, and the name on file at the bank) meet the `match_score` threshold. If the `match_score` is greater than the set threshold, `verified` will be `true`. If not, `verified` will be `false`. By default, this threshold is 54.
      - `match_score` integer: A score between 0 and 100 (inclusive) that indicates how closely the supplied name matches the name on the account. This value is used to determine whether the user's name is successfully `verified`.
    - `display_name` string: The name on the account returned by the bank.
    - `iban` string: The account's IBAN.
    - `swift_bic` string: SWIFT code of account.
    - `account_number` string: The account number.
    - `sort_code` string: The sort code of the account.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable
- `504`: Gateway Timeout

---

[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)