---
title: "Create account holder verification"
method: POST
path: "/v3/account-holder-verifications/requests"
tags: ["Account Holder Verification"]
---

# Create account holder verification

`POST /v3/account-holder-verifications/requests`

## Request

- Base URL: `https://api.truelayer-sandbox.com`
- URL: `https://api.truelayer-sandbox.com/v3/account-holder-verifications/requests`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://auth.truelayer.com/connect/token` scopes: `verification`

Create a request to verify that the provided account holder name matches the name associated with the provided bank account.

## Headers

- `Authorization` string, bearer JWT, required
- `Idempotency-Key` string, required

## Request body

- CreateAccountHolderVerification
  - `account_holder_name` string, required: Name of the account holder to verify.
  - `account_identifier` union, required: The identifier of the account holder's account.
    - object: 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.
    - object: 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.

## Response `202`

Account holder verification

- object
  - `id` string, uuid, required: ID of the account holder verification request

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `409`: Idempotency-Key Concurrency Conflict
- `422`: Idempotency-Key Reuse
- `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)