IDENTITY VERIFICATION

NIN Validation

Perform an advanced validation of a NIN or tracking ID. This endpoint utilizes smart caching logic to return saved information if it exists in our system.

POST /api/v1/nin-validation

Authentication & Headers

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

Request Parameters

PARAMETER	TYPE	DESCRIPTION	REQUIRED
`tracking_id`	string	The Tracking ID or 11-digit National Identity Number.	Required

Example Request

cURL

curl -X POST "https://www.api.arewasmart.com.ng/api/v1/nin-validation" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json" \
  -d "tracking_id=12345678901"

Success Response (Validation)

{
    "status": true,
    "message": "NIN Validation Successful",
    "source": "cached",
     "data": {
        "nin": "12345678901",
        "tracking_id": "12345678901",
        "firstname": "Fatima",
        "surname": "Umar",
        "validation_status": "Valid",
        "verified_at": "2024-03-05T15:20:00Z"
    }
}