---
title: "Verify account details."
method: POST
path: "/v3/verification/fr/verify-account-details"
tags: ["Account Verification"]
---

# Verify account details.

`POST /v3/verification/fr/verify-account-details`

## Request

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

Verify supplied name, account type and date of birth with account holder's name, account type and date of birth.

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

## Headers

- `Authorization` string, bearer JWT, required

## Request body

- VerifyAccountDetailsRequest
  - `name` string, required: Account holder name to verify.
  - `account_identifier` Iban, required: 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.
  - `account_type` 'personal' | 'business', required: Account type to verify.
  - `date_of_birth` string: Account holder date of birth to verify, in `YYYY-MM-DD` format.

## Response `200`

OK

- VerifyAccountDetailsResponse
  - `name_match` NameMatch, required
    - `type` 'match' | 'partial_match' | 'no_match', required: This field represents the type of match between the provided name and the account holder's name. It is a string that can have one of three possible values. </br> ```match``` The provided name perfectly matches the account holder's name.</br> ```partial_match``` The provided name partially matches the account holder's name.</br> ```no_match``` There is no match between the provided name and the account holder's name.
    - `match_score` integer, required: This field represents the score of the name match, indicating the degree of similarity between the provided name and the account holder's name.</br> ```match``` -> The provided name perfectly matches the account holder's name. Score is 100.</br> ```partial_match```-> The provided name partially matches the account holder's name. Score ranges from 88 to 99. </br> ```no_match```-> There is no match between the provided name and the account holder's name. Score ranges from 0 to 87.
  - `account_type_match` AccountTypeMatch, required
    - `type` 'match' | 'no_match' | 'unknown', required: This field represents the result of matching the provided account type with the actual account type. It is a string that can have one of three possible values.</br> ```match``` The provided account type perfectly matches the actual account type.</br> ```no_match``` There is no match between the provided account type and the actual account type.</br> ```unknown``` The result of the account type match could not be determined.
  - `account_status` 'active' | 'inactive' | 'opted_out_from_scheme' | 'unknown', required: This field represents the current status of the account. It can have one of four possible values. </br> ```active``` The account is currently active and in good standing.</br> ```inactive``` The account is currently inactive.</br> ```opted_out_from_scheme``` The account has been opted out of sharing details with the underlying scheme.</br> ```unknown``` The status of the account could not be determined.
  - `date_of_birth_match` DateOfBirthMatch
    - `type` 'match' | 'no_match' | 'unknown', required: This field represents the result of matching the provided date of birth with the account holder's date of birth. It is a string that can have one of three possible values.</br> ```match``` The provided date of birth perfectly matches the account holder's date of birth.</br> ```no_match``` There is no match between the provided date of birth and the account holder's date of birth.</br> ```unknown``` The result of the date of birth match could not be determined.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `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)