---
title: "Account Holder Verification Webhooks"
method: POST
path: "account-holder-verification"
tags: ["Account Holder Verification"]
---

# Account Holder Verification Webhooks

`POST account-holder-verification` (webhook)

Sent to the webhook URI you registered in Console when:
- An account holder verification request completes successfully.
- An account holder verification request fails.

## Headers

- `Tl-Signature` string, required

## Payload

- union
  - AccountHolderVerificationCompleted: Webhook payload sent when an account holder verification request completes successfully.
    - `type` 'account_holder_verification_completed', required
    - `event_version` 1, required: The version of the event schema.
    - `event_id` string, uuid, required: Unique ID of the event.
    - `account_holder_verification_id` string, uuid, required: The ID of the account holder verification request
    - `match_result` union, required: The result of the verification
      - 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.
  - AccountHolderVerificationFailed: Webhook payload sent when an account holder verification request fails.
    - `type` 'account_holder_verification_failed', required
    - `event_version` 1, required: The version of the event schema.
    - `event_id` string, uuid, required: Unique ID of the event.
    - `account_holder_verification_id` string, uuid, required: The ID of the account holder verification request
    - `failure_reason` string, required: Reason for the verification failure

## Acknowledgement `200`

Webhook Handled

---

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