---
title: "Name Verification Service"
method: POST
path: "/v1/cards/verify"
tags: ["/v1/cards"]
---

# Name Verification Service

`POST /v1/cards/verify`

Verifies the provided cardholder’s name details (firstname, middle name, or lastname).

## Request body

- CardsNameVerificationRequest
  - `pan` string, required — Card number
  - `cardHolderNameVerification` CardHolderNameVerification, required — Cardholder name
    - `firstName` string — Cardholder firstname
    - `lastName` string — Cardholder lastname
    - `middleName` string — Cardholder middle name

## Response `200`

Name verification successfully processed

- CardsNameVerificationResponse
  - `cardHolderNameVerification` CardHolderNameVerificationResults — Cardholder name verification results
    - `nameMatch` 'NONE' | 'PARTIAL' | 'FULL'
    - `firstNameMatch` 'NONE' | 'PARTIAL' | 'FULL'
    - `lastNameMatch` 'NONE' | 'PARTIAL' | 'FULL'
    - `middleNameMatch` 'NONE' | 'PARTIAL' | 'FULL'

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.dev/pci-proxy/apis/pci-proxy-api-reference-datatrans-endpoints.md) · [All operations](https://skmtc.dev/pci-proxy/apis/pci-proxy-api-reference-datatrans-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pci-proxy/pci-proxy-api-reference-datatrans-endpoints/revisions/1f4f905fd175/schema)