---
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}`

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.net/truelayer/apis/authentication-server.md) · [All operations](https://skmtc.net/truelayer/apis/authentication-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truelayer/authentication-server/revisions/5f6051515b2c/schema)
