---
title: "Get account holder verification"
method: GET
path: "/v3/account-holder-verifications/requests/{id}"
tags: ["Account Holder Verification"]
---

# Get account holder verification

`GET /v3/account-holder-verifications/requests/{id}`

## Request

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

Returns the results of account holder verification for the given ID.

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

## Path parameters

- `id` string, required

## Response `200`

OK

- union
  - CompletedAccountHolderVerification
    - `id` string, uuid, required: ID of the account holder verification request
    - `status` 'completed', required: Current status of the account holder verification request
    - `match_result` union, required: Verification result. Present when status is completed.
      - MatchResult
        - `type` 'match', required: The result of the name matching process. Aligned with provider responses.
      - PartialMatchResult
        - `type` 'partial_match', required: The result of the name matching process. Aligned with provider responses.
        - `account_holder_name` string, required: Account holder name returned by the provider. Present for `partial_match` results.
      - NoMatchResult
        - `type` 'no_match', required: The result of the name matching process. Aligned with provider responses.
      - MatchNotPossibleResult
        - `type` 'match_not_possible', required: The result of the name matching process. Aligned with provider responses.
        - `reason` string, required: Reason for the verification not being possible.
  - PendingAccountHolderVerification
    - `id` string, uuid, required: ID of the account holder verification request
    - `status` 'pending', required: Current status of the account holder verification request
  - FailedAccountHolderVerification
    - `id` string, uuid, required: ID of the account holder verification request
    - `status` 'failed', required: Current status of the account holder verification request
    - `failure_reason` string, required: Reason for the verification failure. Present when status is failed.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `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)