NIN Demo Verification API

Retrieve and verify National Identity records using demographic information (Name, Gender, and Date of Birth).

Service Online / Available

POST /api/v1/nin/demo

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
`604`	NIN Demo Verification	₦200.00	Available

Request Parameters

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`firstName`	string	First name of the individual (e.g. `John`).	Required
`lastName`	string	Surname / Last name of the individual (e.g. `Doe`).	Required
`gender`	string	Gender code: `M` or `F`.	Required
`dateOfBirth`	string	Date of birth format (e.g., `22-02-2002`).	Required
`ref`	string	Unique client reference identifier.	Optional

Example Request

cURL

curl -X POST "https://www.api.arewasmart.com.ng/api/v1/nin/demo" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "firstName": "John",
    "lastName": "Doe",
    "gender": "M",
    "dateOfBirth": "22-02-2002"
  }'

Success Response (200 OK)

{
    "status": "success",
    "code": 200,
    "message": "verification sucessful",
    "data": {
        "firstname": "John",
        "surname": "Doe",
        "gender": "m",
        "birthdate": "2002-02-22",
        "nin": "12345678901",
        "photo": "..."
    },
    "transaction_ref": "NIND2134ABCDE",
    "charge": 100.00
}