---
title: "Verify Name"
method: POST
path: "/insights/v1/name-verification"
tags: ["Name Verification"]
---

# Verify Name

`POST /insights/v1/name-verification`

Verify the name held by the bank matches a name provided. Requires the following permissions: accounts & identity.

## Request body

- NameVerificationRequestDto
  - `entity_id` string, uuid, required
  - `full_name` string, required
  - `async` boolean
  - `meta` object

## Response `200`

OK

- DataRequestResultNameVerificationDto
  - `status` 'OK' | 'PENDING' | 'FAILED' | 'CONSENT_EXPIRED' | 'RECONNECT_REQUIRED' | 'PROCESSING_STARTED' — The status of the request
  - `results_id` string, uuid
  - `message` string
  - `meta` object
  - `timestamp` string, date-time
  - `status_detail` StatusAdditionalDetail
    - `granular_status_code` string
    - `status_additional_info` string
  - `data` NameVerificationDto — An end user's name verification based on data held by a financial institution
    - `type` string
    - `full_name_provided` string — Full name provided in request
    - `full_name_retrieved` string — Full name retrieved from financial institution
    - `match_type` 'PERFECT_MATCH' | 'NO_MATCH' | 'PARTIAL_MATCH' — Match type
    - `confidence` number — Between 0 and 1
  - `type` string
  - `refreshed_at` string, date-time

---

[API](https://skmtc.net/leantech/apis/auth.md) · [All operations](https://skmtc.net/leantech/apis/auth/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leantech/auth/revisions/c2e46d54d886/schema)