API Documentation
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"
}
}