NIN V2 Verification API

High-reliability secondary endpoint to verify National Identity Number (NIN) records with comprehensive demographic data.

Service Online / Available

POST /api/v1/nin/v2

Authentication & Headers

HEADER	VALUE	REQUIRED
`Authorization`	`Bearer YOUR_API_TOKEN`	Yes
`Accept`	`application/json`	Yes
`Content-Type`	`application/json`	Yes

Service Availability & Realtime Pricing

Role: Default

SERVICE / FIELD CODE	SERVICE NAME	PRICE (₦)	STATUS
`V606`	NIN v2 Verification	₦120.00	Available

Request Parameters

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`nin` / `vnin`	string	The 11-digit National Identity Number or Virtual NIN (vNIN).	Required
`ref`	string	Optional unique reference identifier.	Optional

Example Request

cURL

curl -X POST "https://www.api.arewasmart.com.ng/api/v1/nin/v2" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"nin": "12345678901"}'

Success Response (200 OK)

{
    "status": "success",
    "code": 200,
    "message": "verification sucessful",
    "data": {
        "nin": "12345678901",
        "firstName": "John",
        "middleName": "Smith",
        "surname": "Doe",
        "gender": "m",
        "birthDate": "1990-01-01",
        "phoneNumber": "08012345678",
        "photo": "...",
        "reference": "NIN12345ABCDE",
        "submission_date": "2026-03-20 12:00:00"
    },
    "transaction_ref": "NIN12345ABCDE",
    "charge": 100.00
}