---
title: "Initiate an account verification check"
method: POST
path: "/account-verifications"
tags: ["Verification"]
---

# Initiate an account verification check

`POST /account-verifications`

This endpoint allows clients to verify whether the provided account details (such as sort code and account number or IBAN) match the name of the intended account holder, whether an individual or a business

## Request body

- AccountVerificationRequest
  - `account` object, required — Account information for account verification
    - `name` string, required — Name of account holder
    - `currency` 'EUR', required — Specifies the currency of the account being verified, represented in ISO 4217 three-letter format (e.g. EUR). This ensures accurate matching where account validation rules or naming conventions may vary by currency.
    - `iban` string, required — The International Bank Account Number (IBAN) which identifies a bank account across borders
  - `virtualAccountId` string — The Token settlement account from which the subsequent payout or refund will be executed. > **Conditional** - If this verification check is independent of a Token provided settlement account, this should **NOT** be provided.

## Response `200`

OK

- AccountVerificationResponse
  - `id` string, required
  - `result` object, required
    - `status` 'MATCH' | 'NO_MATCH' | 'CLOSE_MATCH' | 'VERIFICATION_NOT_POSSIBLE', required — The outcome of the verification
    - `reasons` string[], required — A more granular reason as to why there was not a full match
    - `details` string, required — A human readable explanation for the outcome of the verification check
    - `matched` object — Further details on the attributes that would result in a full match
      - `name` string — The name matched to the account provided

## Other responses

- `400` — The client specified an invalid argument

---

[API](https://skmtc.net/token/apis/token-io-s-open-banking-api-for-tpps.md) · [All operations](https://skmtc.net/token/apis/token-io-s-open-banking-api-for-tpps/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/token/token-io-s-open-banking-api-for-tpps/versions/5e8d6d2c24a1/schema)