API Documentation
National Identity Number (NIN) Verification
The NIN Verification endpoint allows you to verify the identity of individuals using their National Identity Number.
Endpoint
POST
/nin
Headers
| Header | Value | Required |
|---|---|---|
Authorization |
Bearer YOUR_API_TOKEN |
Required |
Accept |
application/json |
Required |
Parameters
| Parameter | Type | Description | Required |
|---|---|---|---|
nin |
string |
The 11-digit National Identity Number. | Required |
Example Request
PHP (cURL)
<?php
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://arewasmart.com.ng/api/nin',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => array('nin' => '12345678901'),
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer YOUR_API_TOKEN',
'Accept: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
Example Response
JSON
{
"status": true,
"message": "NIN Verified Successfully",
"data": {
"firstname": "John",
"surname": "Doe",
"middlename": "Smith",
"birthdate": "1990-01-01",
"gender": "m",
"photo": "base64_encoded_string..."
}
}