API Documentation
National Identity Number (NIN) DEMO Verification
Test the basic NIN verification process using our DEMO endpoint without incurring real charges or needing real NIN records during development.
Endpoint
POST
/nin-demo
Headers
| Header | Value | Required |
|---|---|---|
Authorization |
Bearer YOUR_API_TOKEN |
Required |
Accept |
application/json |
Required |
Parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
nin |
string |
A sample or demo 11-digit NIN (e.g., 11111111111). |
Required |
Example Request
cURL
curl -X POST "https://arewasmart.com.ng/api/nin-demo" \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Accept: application/json" \
-d "nin=11111111111"
Example Response
JSON
{
"status": true,
"message": "Demo NIN Verified Successfully",
"data": {
"nin": "11111111111",
"firstname": "Demo",
"surname": "User",
"middlename": "Test",
"birthdate": "1990-10-10",
"gender": "m",
"photo": "base64_encoded_string..."
}
}