API Documentation
Login Get API Key

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, reducing your wait time, otherwise, it fetches the data directly from the national registry.

Endpoint

POST /nin-validation

Headers

Header Value Required
Authorization Bearer YOUR_API_TOKEN Required
Accept application/json Required

Parameters

Parameter Type Description Required
tracking_id string The Tracking ID or NIN to validate. Required

Example Request

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

Example Response

JSON
{
    "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"
    }
}