---
title: "Basic NIN Verification"
method: POST
path: "/api/v1/merchant/nin/basic"
tags: ["Identity Verification"]
---

# Basic NIN Verification

`POST /api/v1/merchant/nin/basic`

Verify a NIN against submitted identity details such as first name, middle name, last name, gender, date of birth, and phone number.

## Headers

- `api-key` string, required
- `api-secret` string, required
- `Content-Type` 'application/json', required

## Request body

- BasicNinVerificationRequest
  - `nin` string, required — Customer NIN
  - `first_name` string, required — Customer first name
  - `last_name` string, required — Customer last name
  - `middle_name` string, required — Customer middle name
  - `gender` 'MALE' | 'FEMALE', required — Customer gender
  - `birthday` string, date, required — Customer date of birth
  - `phone_number` string, required — Customer phone number

## Response `200`

NIN verification response

- BasicNinVerificationResponse
  - `success` boolean, required — Whether the request completed successfully
  - `message` string, required — Response message
  - `data` BasicNinVerificationData, required
    - `name_match_rlt` string, required — Result of the name match check
    - `names_match_percentage` string, required — Percentage score for matched names
    - `birthday_match_rlt` string, required — Result of the birthday match check
    - `gender_match_rlt` string, required — Result of the gender match check
    - `phone_number_match_rlt` string, required — Result of the phone number match check
  - `charges` VerificationCharges, required
    - `charged` boolean, required — Whether the verification request was billed
    - `charged_amount` string, required — Amount charged for the verification request

## Other responses

- `402` — Verification could not be processed because the wallet balance is insufficient

---

[API](https://skmtc.net/payvessel/apis/payvessel-value-added-services-api.md) · [All operations](https://skmtc.net/payvessel/apis/payvessel-value-added-services-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payvessel/payvessel-value-added-services-api/versions/31040a9358ef/schema)