Complete reference for all available endpoints, parameters, and response formats.
https://nangereverify.com.ng/api/v1POST (GET for balance)application/jsonAuthorization: Bearer API_KEYEvery NANGERE API call works the same way: send a POST request with a JSON body and your API key in the Authorization header. Every response is JSON with "success": true or "success": false, a message and data.
https://nangereverify.com.ng/api/v1/… with Authorization: Bearer YOUR_API_KEY.success. Instant services return data straight away; queued services return a reference you check with their /status endpoint.These services are processed in a queue. You submit the request, it is processed, and you collect the result with a free status check. Your wallet is charged when the request is accepted; if it cannot be completed, the money is refunded automatically.
client_refdata.reference and status: processing…/status at most once a minute| processing | Received and being worked on. You have been charged. |
| completed | Done. The result is in data.result. |
| failed | Could not be completed. data.refunded is true and the money is back in your wallet. |
<?php
// 1) Submit the request (IPE Clearance shown; Validation / Personalization work the same way)
function nangere(string $method, string $endpoint, array $data = []): array {
$ch = curl_init('https://nangereverify.com.ng/api/v1' . $endpoint);
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => $method,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => $data ? json_encode($data) : null,
CURLOPT_TIMEOUT => 60,
]);
$res = json_decode(curl_exec($ch), true) ?: ['success' => false, 'message' => 'No response'];
curl_close($ch);
return $res;
}
$submit = nangere('POST', '/nin/ipe-clearance', [
'tracking_id' => '7GH2K9LM3PQ8R1T',
'client_ref' => 'ORDER-30001', // your order ID: safe to retry, never charged twice
]);
if (!$submit['success']) exit('Error: ' . $submit['message']);
$reference = $submit['data']['reference']; // save this in your database
// 2) Later (e.g. a cron job every 5 minutes) check the result — free
$status = nangere('POST', '/nin/ipe-clearance/status', ['reference' => $reference]);
$state = $status['data']['status'] ?? 'processing';
if ($state === 'completed') {
echo 'Done: ' . json_encode($status['data']['result']);
} elseif ($state === 'failed') {
echo 'Failed and refunded: ' . $status['message'];
} else {
echo 'Still processing — check again later.';
}// Node.js 18+ (fetch is built in)
const BASE = 'https://nangereverify.com.ng/api/v1';
const API_KEY = 'YOUR_API_KEY';
async function nangere(endpoint, data) {
const res = await fetch(BASE + endpoint, {
method: 'POST',
headers: { Authorization: 'Bearer ' + API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify(data),
});
return res.json();
}
// 1) Submit the request
const submit = await nangere('/nin/ipe-clearance', { tracking_id: '7GH2K9LM3PQ8R1T', client_ref: 'ORDER-30001' });
if (!submit.success) throw new Error(submit.message);
const reference = submit.data.reference; // save this
// 2) Check the result every 5 minutes until it is finished
const timer = setInterval(async () => {
const s = await nangere('/nin/ipe-clearance/status', { reference });
if (s.data?.status === 'completed') { console.log('Done:', s.data.result); clearInterval(timer); }
else if (s.data?.status === 'failed') { console.log('Failed and refunded:', s.message); clearInterval(timer); }
}, 5 * 60 * 1000);import time, requests
BASE = "https://nangereverify.com.ng/api/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}
def nangere(endpoint, data):
return requests.post(BASE + endpoint, json=data, headers=HEADERS, timeout=60).json()
# 1) Submit the request
submit = nangere("/nin/ipe-clearance", {"tracking_id": "7GH2K9LM3PQ8R1T", "client_ref": "ORDER-30001"})
if not submit["success"]:
raise SystemExit("Error: " + submit["message"])
reference = submit["data"]["reference"] # save this
# 2) Check the result every 5 minutes until it is finished
while True:
s = nangere("/nin/ipe-clearance/status", {"reference": reference})
state = s.get("data", {}).get("status")
if state == "completed":
print("Done:", s["data"]["result"]); break
if state == "failed":
print("Failed and refunded:", s["message"]); break
time.sleep(300)/balance
Check the balance of the wallet your API key is charged from. This request is free.
GET https://nangereverify.com.ng/api/v1/balance
| Field | Type | Required | Description |
|---|---|---|---|
Authorization | header | Yes | Bearer YOUR_API_KEY (or send it as X-API-Key) |
// No body — send only the Authorization header{
"success": true,
"message": "OK",
"data": {
"balance": 15250,
"currency": "NGN"
}
}curl https://nangereverify.com.ng/api/v1/balance \
-H 'Authorization: Bearer YOUR_API_KEY'<?php
$ch = curl_init('https://nangereverify.com.ng/api/v1/balance');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['Authorization: Bearer YOUR_API_KEY'],
CURLOPT_TIMEOUT => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if ($result['success']) {
echo 'Balance: ' . $result['data']['balance'];
} else {
echo 'Error: ' . $result['message'];
}const res = await fetch('https://nangereverify.com.ng/api/v1/balance', {
headers: { Authorization: 'Bearer YOUR_API_KEY' },
});
const result = await res.json();
if (result.success) console.log('Balance:', result.data.balance);
else console.error('Error:', result.message);import requests
result = requests.get(
"https://nangereverify.com.ng/api/v1/balance",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=60,
).json()
if result["success"]:
print("Balance:", result["data"]["balance"])
else:
print("Error:", result["message"])/nin/verify
Verify an 11-digit National Identification Number and get the holder's details and photo instantly.
POST https://nangereverify.com.ng/api/v1/nin/verify
| Field | Type | Required | Description |
|---|---|---|---|
Authorization | header | Yes | Bearer YOUR_API_KEY (or send it as X-API-Key) |
variant | string | Yes | Slip type, e.g. nin-premium-slip (see Variants & prices) |
nin | string | Yes | 11-digit NIN |
client_ref | string | No | Your unique order ID (max 80 characters). Resending it returns the first result and does not charge you again |
| variant | Name | Price |
|---|---|---|
nin-premium-slip | Premium Slip | ₦200 |
nin-standard-slip | Standard Slip | ₦150 |
nin-regular-slip | Regular Slip | ₦150 |
nin-vnin-slip | VNIN Slip | ₦500 |
{
"variant": "nin-premium-slip",
"nin": "12345678901",
"client_ref": "ORDER-10045"
}{
"success": true,
"message": "Request completed successfully.",
"data": {
"reference": "API1A2B3C4D1761800000",
"status": "completed",
"amount": 200,
"balance": 15050,
"result": {
"nin": "12345678901",
"first_name": "JOHN",
"middle_name": "ADE",
"last_name": "DOE",
"date_of_birth": "1990-01-15",
"gender": "male",
"phone": "08030000000",
"photo": "base64..."
}
}
}curl -X POST \
https://nangereverify.com.ng/api/v1/nin/verify \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"variant":"nin-premium-slip","nin":"12345678901","client_ref":"ORDER-10045"}'<?php
$ch = curl_init('https://nangereverify.com.ng/api/v1/nin/verify');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'variant' => 'nin-premium-slip',
'nin' => '12345678901',
'client_ref' => 'ORDER-10045',
]),
CURLOPT_TIMEOUT => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if ($result['success']) {
print_r($result['data']);
} else {
echo 'Error: ' . $result['message'];
}const res = await fetch('https://nangereverify.com.ng/api/v1/nin/verify', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"variant": "nin-premium-slip",
"nin": "12345678901",
"client_ref": "ORDER-10045"
}),
});
const result = await res.json();
if (result.success) console.log(result.data);
else console.error('Error:', result.message);import requests
result = requests.post(
"https://nangereverify.com.ng/api/v1/nin/verify",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"variant": "nin-premium-slip",
"nin": "12345678901",
"client_ref": "ORDER-10045"
},
timeout=60,
).json()
if result["success"]:
print(result["data"])
else:
print("Error:", result["message"])/nin/verify
Find and verify a NIN using the phone number linked to it.
POST https://nangereverify.com.ng/api/v1/nin/verify
| Field | Type | Required | Description |
|---|---|---|---|
Authorization | header | Yes | Bearer YOUR_API_KEY (or send it as X-API-Key) |
variant | string | Yes | Slip type, e.g. nin-premium-slip |
phone | string | Yes | 11-digit phone number, e.g. 08030000000 |
client_ref | string | No | Your unique order ID (max 80 characters). Resending it returns the first result and does not charge you again |
| variant | Name | Price |
|---|---|---|
nin-premium-slip | Premium Slip | ₦200 |
nin-standard-slip | Standard Slip | ₦150 |
nin-regular-slip | Regular Slip | ₦150 |
nin-vnin-slip | VNIN Slip | ₦500 |
{
"variant": "nin-premium-slip",
"phone": "08030000000",
"client_ref": "ORDER-10046"
}{
"success": true,
"message": "Request completed successfully.",
"data": {
"reference": "API2B3C4D5E1761800010",
"status": "completed",
"amount": 200,
"balance": 14850,
"result": {
"nin": "12345678901",
"first_name": "JOHN",
"last_name": "DOE",
"phone": "08030000000",
"photo": "base64..."
}
}
}curl -X POST \
https://nangereverify.com.ng/api/v1/nin/verify \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"variant":"nin-premium-slip","phone":"08030000000","client_ref":"ORDER-10046"}'<?php
$ch = curl_init('https://nangereverify.com.ng/api/v1/nin/verify');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'variant' => 'nin-premium-slip',
'phone' => '08030000000',
'client_ref' => 'ORDER-10046',
]),
CURLOPT_TIMEOUT => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if ($result['success']) {
print_r($result['data']);
} else {
echo 'Error: ' . $result['message'];
}const res = await fetch('https://nangereverify.com.ng/api/v1/nin/verify', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"variant": "nin-premium-slip",
"phone": "08030000000",
"client_ref": "ORDER-10046"
}),
});
const result = await res.json();
if (result.success) console.log(result.data);
else console.error('Error:', result.message);import requests
result = requests.post(
"https://nangereverify.com.ng/api/v1/nin/verify",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"variant": "nin-premium-slip",
"phone": "08030000000",
"client_ref": "ORDER-10046"
},
timeout=60,
).json()
if result["success"]:
print(result["data"])
else:
print("Error:", result["message"])/nin/verify
Find and verify a NIN using first name, last name, date of birth and gender.
POST https://nangereverify.com.ng/api/v1/nin/verify
| Field | Type | Required | Description |
|---|---|---|---|
Authorization | header | Yes | Bearer YOUR_API_KEY (or send it as X-API-Key) |
variant | string | Yes | Slip type, e.g. nin-premium-slip |
first_name | string | Yes | First name |
last_name | string | Yes | Last name (surname) |
date_of_birth | string | Yes | Date of birth as YYYY-MM-DD |
gender | string | Yes | male or female |
client_ref | string | No | Your unique order ID (max 80 characters). Resending it returns the first result and does not charge you again |
| variant | Name | Price |
|---|---|---|
nin-premium-slip | Premium Slip | ₦200 |
nin-standard-slip | Standard Slip | ₦150 |
nin-regular-slip | Regular Slip | ₦150 |
nin-vnin-slip | VNIN Slip | ₦500 |
{
"variant": "nin-premium-slip",
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1990-01-15",
"gender": "male",
"client_ref": "ORDER-10047"
}{
"success": true,
"message": "Request completed successfully.",
"data": {
"reference": "API3C4D5E6F1761800020",
"status": "completed",
"amount": 200,
"balance": 14650,
"result": {
"nin": "12345678901",
"first_name": "JOHN",
"last_name": "DOE",
"date_of_birth": "1990-01-15",
"photo": "base64..."
}
}
}curl -X POST \
https://nangereverify.com.ng/api/v1/nin/verify \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"variant":"nin-premium-slip","first_name":"John","last_name":"Doe","date_of_birth":"1990-01-15","gender":"male","client_ref":"ORDER-10047"}'<?php
$ch = curl_init('https://nangereverify.com.ng/api/v1/nin/verify');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'variant' => 'nin-premium-slip',
'first_name' => 'John',
'last_name' => 'Doe',
'date_of_birth' => '1990-01-15',
'gender' => 'male',
'client_ref' => 'ORDER-10047',
]),
CURLOPT_TIMEOUT => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if ($result['success']) {
print_r($result['data']);
} else {
echo 'Error: ' . $result['message'];
}const res = await fetch('https://nangereverify.com.ng/api/v1/nin/verify', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"variant": "nin-premium-slip",
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1990-01-15",
"gender": "male",
"client_ref": "ORDER-10047"
}),
});
const result = await res.json();
if (result.success) console.log(result.data);
else console.error('Error:', result.message);import requests
result = requests.post(
"https://nangereverify.com.ng/api/v1/nin/verify",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"variant": "nin-premium-slip",
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1990-01-15",
"gender": "male",
"client_ref": "ORDER-10047"
},
timeout=60,
).json()
if result["success"]:
print(result["data"])
else:
print("Error:", result["message"])/bvn/verify
Verify an 11-digit Bank Verification Number and get the holder's details and photo instantly.
POST https://nangereverify.com.ng/api/v1/bvn/verify
| Field | Type | Required | Description |
|---|---|---|---|
Authorization | header | Yes | Bearer YOUR_API_KEY (or send it as X-API-Key) |
variant | string | Yes | Verification type, e.g. bvn-premium-slip (see Variants & prices) |
bvn | string | Yes | 11-digit BVN |
client_ref | string | No | Your unique order ID (max 80 characters). Resending it returns the first result and does not charge you again |
| variant | Name | Price |
|---|---|---|
bvn-full-details | Full Details | ₦200 |
bvn-premium-slip | Premium Slip | ₦200 |
{
"variant": "bvn-premium-slip",
"bvn": "22234567890",
"client_ref": "ORDER-20001"
}{
"success": true,
"message": "Request completed successfully.",
"data": {
"reference": "API5E6F7A8B1761800100",
"status": "completed",
"amount": 200,
"balance": 14450,
"result": {
"bvn": "22234567890",
"first_name": "JOHN",
"last_name": "DOE",
"date_of_birth": "15-Jan-1990",
"phone": "08030000000",
"photo": "base64..."
}
}
}curl -X POST \
https://nangereverify.com.ng/api/v1/bvn/verify \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"variant":"bvn-premium-slip","bvn":"22234567890","client_ref":"ORDER-20001"}'<?php
$ch = curl_init('https://nangereverify.com.ng/api/v1/bvn/verify');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'variant' => 'bvn-premium-slip',
'bvn' => '22234567890',
'client_ref' => 'ORDER-20001',
]),
CURLOPT_TIMEOUT => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if ($result['success']) {
print_r($result['data']);
} else {
echo 'Error: ' . $result['message'];
}const res = await fetch('https://nangereverify.com.ng/api/v1/bvn/verify', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"variant": "bvn-premium-slip",
"bvn": "22234567890",
"client_ref": "ORDER-20001"
}),
});
const result = await res.json();
if (result.success) console.log(result.data);
else console.error('Error:', result.message);import requests
result = requests.post(
"https://nangereverify.com.ng/api/v1/bvn/verify",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"variant": "bvn-premium-slip",
"bvn": "22234567890",
"client_ref": "ORDER-20001"
},
timeout=60,
).json()
if result["success"]:
print(result["data"])
else:
print("Error:", result["message"])/nin/ipe-clearance
Clear an IPE (In-Process Error) on a NIMC enrolment with its Tracking ID. data.status is completed, or processing while it is still being worked on.
POST https://nangereverify.com.ng/api/v1/nin/ipe-clearance
| Field | Type | Required | Description |
|---|---|---|---|
Authorization | header | Yes | Bearer YOUR_API_KEY (or send it as X-API-Key) |
tracking_id | string | Yes | The 15-character NIMC Tracking ID, e.g. 7GH2K9LM3PQ8R1T |
client_ref | string | No | Your unique order ID (max 80 characters). Resending it returns the first result and does not charge you again |
status: processing. Save data.reference and check it with the matching Status endpoint. If it fails, you are refunded automatically.{
"tracking_id": "7GH2K9LM3PQ8R1T",
"client_ref": "ORDER-30001"
}{
"success": true,
"message": "Request submitted and is being processed. Check its status later; you are refunded automatically if it fails.",
"data": {
"reference": "API7C1D2E3F1761800400",
"status": "processing",
"amount": 800,
"balance": 14200,
"result": {
"message": "IPE clearance request received"
}
}
}curl -X POST \
https://nangereverify.com.ng/api/v1/nin/ipe-clearance \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"tracking_id":"7GH2K9LM3PQ8R1T","client_ref":"ORDER-30001"}'<?php
$ch = curl_init('https://nangereverify.com.ng/api/v1/nin/ipe-clearance');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'tracking_id' => '7GH2K9LM3PQ8R1T',
'client_ref' => 'ORDER-30001',
]),
CURLOPT_TIMEOUT => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if ($result['success']) {
print_r($result['data']);
} else {
echo 'Error: ' . $result['message'];
}const res = await fetch('https://nangereverify.com.ng/api/v1/nin/ipe-clearance', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"tracking_id": "7GH2K9LM3PQ8R1T",
"client_ref": "ORDER-30001"
}),
});
const result = await res.json();
if (result.success) console.log(result.data);
else console.error('Error:', result.message);import requests
result = requests.post(
"https://nangereverify.com.ng/api/v1/nin/ipe-clearance",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"tracking_id": "7GH2K9LM3PQ8R1T",
"client_ref": "ORDER-30001"
},
timeout=60,
).json()
if result["success"]:
print(result["data"])
else:
print("Error:", result["message"])/nin/ipe-clearance/status
Get the latest status of an IPE clearance. Send the reference we returned or the tracking_id. Free — check each request at most once a minute.
POST https://nangereverify.com.ng/api/v1/nin/ipe-clearance/status
| Field | Type | Required | Description |
|---|---|---|---|
Authorization | header | Yes | Bearer YOUR_API_KEY (or send it as X-API-Key) |
reference | string | No | The reference from the submit response |
tracking_id | string | No | Or the Tracking ID you submitted. One of the two is required |
{
"tracking_id": "7GH2K9LM3PQ8R1T"
}{
"success": true,
"message": "Request completed.",
"data": {
"reference": "API7C1D2E3F1761800400",
"service": "nin-ipe-clearance",
"status": "completed",
"amount": 800,
"refunded": false,
"created_at": "2026-10-30 10:15:02",
"result": {
"message": "Done"
},
"tracking_id": "7GH2K9LM3PQ8R1T"
}
}curl -X POST \
https://nangereverify.com.ng/api/v1/nin/ipe-clearance/status \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"tracking_id":"7GH2K9LM3PQ8R1T"}'<?php
$ch = curl_init('https://nangereverify.com.ng/api/v1/nin/ipe-clearance/status');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'tracking_id' => '7GH2K9LM3PQ8R1T',
]),
CURLOPT_TIMEOUT => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if ($result['success']) {
print_r($result['data']);
} else {
echo 'Error: ' . $result['message'];
}const res = await fetch('https://nangereverify.com.ng/api/v1/nin/ipe-clearance/status', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"tracking_id": "7GH2K9LM3PQ8R1T"
}),
});
const result = await res.json();
if (result.success) console.log(result.data);
else console.error('Error:', result.message);import requests
result = requests.post(
"https://nangereverify.com.ng/api/v1/nin/ipe-clearance/status",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"tracking_id": "7GH2K9LM3PQ8R1T"
},
timeout=60,
).json()
if result["success"]:
print(result["data"])
else:
print("Error:", result["message"])/nin/validation
Submit a NIN for validation (for example after a modification, or when the NIN returns "no record found").
POST https://nangereverify.com.ng/api/v1/nin/validation
| Field | Type | Required | Description |
|---|---|---|---|
Authorization | header | Yes | Bearer YOUR_API_KEY (or send it as X-API-Key) |
variant | string | Yes | Validation type, e.g. nin-no-record-found (see Variants & prices) |
nin | string | Yes | 11-digit NIN |
client_ref | string | No | Your unique order ID (max 80 characters). Resending it returns the first result and does not charge you again |
| variant | Name | Price |
|---|---|---|
nin-no-record-found | No Record Found | ₦1,300 |
nin-modification-validation | Modification Validation | ₦2,000 |
status: processing. Save data.reference and check it with the matching Status endpoint. If it fails, you are refunded automatically.{
"variant": "nin-no-record-found",
"nin": "12345678901",
"client_ref": "ORDER-40001"
}{
"success": true,
"message": "Request submitted and is being processed. Check its status later; you are refunded automatically if it fails.",
"data": {
"reference": "API7C1D2E3F1761800400",
"status": "processing",
"amount": 1300,
"balance": 14200,
"result": {
"message": "Validation request received"
}
}
}curl -X POST \
https://nangereverify.com.ng/api/v1/nin/validation \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"variant":"nin-no-record-found","nin":"12345678901","client_ref":"ORDER-40001"}'<?php
$ch = curl_init('https://nangereverify.com.ng/api/v1/nin/validation');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'variant' => 'nin-no-record-found',
'nin' => '12345678901',
'client_ref' => 'ORDER-40001',
]),
CURLOPT_TIMEOUT => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if ($result['success']) {
print_r($result['data']);
} else {
echo 'Error: ' . $result['message'];
}const res = await fetch('https://nangereverify.com.ng/api/v1/nin/validation', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"variant": "nin-no-record-found",
"nin": "12345678901",
"client_ref": "ORDER-40001"
}),
});
const result = await res.json();
if (result.success) console.log(result.data);
else console.error('Error:', result.message);import requests
result = requests.post(
"https://nangereverify.com.ng/api/v1/nin/validation",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"variant": "nin-no-record-found",
"nin": "12345678901",
"client_ref": "ORDER-40001"
},
timeout=60,
).json()
if result["success"]:
print(result["data"])
else:
print("Error:", result["message"])/nin/validation/status
Get the latest status of a validation. Send the reference we returned or the nin. Free — check each request at most once a minute.
POST https://nangereverify.com.ng/api/v1/nin/validation/status
| Field | Type | Required | Description |
|---|---|---|---|
Authorization | header | Yes | Bearer YOUR_API_KEY (or send it as X-API-Key) |
reference | string | No | The reference from the submit response |
nin | string | No | Or the NIN you submitted. One of the two is required |
{
"nin": "12345678901"
}{
"success": true,
"message": "Request completed.",
"data": {
"reference": "API7C1D2E3F1761800400",
"service": "nin-validation",
"status": "completed",
"amount": 1300,
"refunded": false,
"created_at": "2026-10-30 10:15:02",
"result": {
"message": "Done"
},
"nin": "12345678901"
}
}curl -X POST \
https://nangereverify.com.ng/api/v1/nin/validation/status \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"nin":"12345678901"}'<?php
$ch = curl_init('https://nangereverify.com.ng/api/v1/nin/validation/status');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'nin' => '12345678901',
]),
CURLOPT_TIMEOUT => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if ($result['success']) {
print_r($result['data']);
} else {
echo 'Error: ' . $result['message'];
}const res = await fetch('https://nangereverify.com.ng/api/v1/nin/validation/status', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"nin": "12345678901"
}),
});
const result = await res.json();
if (result.success) console.log(result.data);
else console.error('Error:', result.message);import requests
result = requests.post(
"https://nangereverify.com.ng/api/v1/nin/validation/status",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"nin": "12345678901"
},
timeout=60,
).json()
if result["success"]:
print(result["data"])
else:
print("Error:", result["message"])/nin/personalization
Personalize a NIN with its enrolment Tracking ID.
POST https://nangereverify.com.ng/api/v1/nin/personalization
| Field | Type | Required | Description |
|---|---|---|---|
Authorization | header | Yes | Bearer YOUR_API_KEY (or send it as X-API-Key) |
tracking_id | string | Yes | The 15-character NIMC Tracking ID, e.g. 7GH2K9LM3PQ8R1T |
client_ref | string | No | Your unique order ID (max 80 characters). Resending it returns the first result and does not charge you again |
status: processing. Save data.reference and check it with the matching Status endpoint. If it fails, you are refunded automatically.{
"tracking_id": "7GH2K9LM3PQ8R1T",
"client_ref": "ORDER-50001"
}{
"success": true,
"message": "Request submitted and is being processed. Check its status later; you are refunded automatically if it fails.",
"data": {
"reference": "API7C1D2E3F1761800400",
"status": "processing",
"amount": 250,
"balance": 14200,
"result": {
"message": "Personalization request received"
}
}
}curl -X POST \
https://nangereverify.com.ng/api/v1/nin/personalization \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"tracking_id":"7GH2K9LM3PQ8R1T","client_ref":"ORDER-50001"}'<?php
$ch = curl_init('https://nangereverify.com.ng/api/v1/nin/personalization');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'tracking_id' => '7GH2K9LM3PQ8R1T',
'client_ref' => 'ORDER-50001',
]),
CURLOPT_TIMEOUT => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if ($result['success']) {
print_r($result['data']);
} else {
echo 'Error: ' . $result['message'];
}const res = await fetch('https://nangereverify.com.ng/api/v1/nin/personalization', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"tracking_id": "7GH2K9LM3PQ8R1T",
"client_ref": "ORDER-50001"
}),
});
const result = await res.json();
if (result.success) console.log(result.data);
else console.error('Error:', result.message);import requests
result = requests.post(
"https://nangereverify.com.ng/api/v1/nin/personalization",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"tracking_id": "7GH2K9LM3PQ8R1T",
"client_ref": "ORDER-50001"
},
timeout=60,
).json()
if result["success"]:
print(result["data"])
else:
print("Error:", result["message"])/nin/personalization/status
Get the latest status of a personalization. Send the reference we returned or the tracking_id. Free — check each request at most once a minute.
POST https://nangereverify.com.ng/api/v1/nin/personalization/status
| Field | Type | Required | Description |
|---|---|---|---|
Authorization | header | Yes | Bearer YOUR_API_KEY (or send it as X-API-Key) |
reference | string | No | The reference from the submit response |
tracking_id | string | No | Or the Tracking ID you submitted. One of the two is required |
{
"tracking_id": "7GH2K9LM3PQ8R1T"
}{
"success": true,
"message": "Request completed.",
"data": {
"reference": "API7C1D2E3F1761800400",
"service": "nin-personalization",
"status": "completed",
"amount": 250,
"refunded": false,
"created_at": "2026-10-30 10:15:02",
"result": {
"message": "Done"
},
"tracking_id": "7GH2K9LM3PQ8R1T"
}
}curl -X POST \
https://nangereverify.com.ng/api/v1/nin/personalization/status \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"tracking_id":"7GH2K9LM3PQ8R1T"}'<?php
$ch = curl_init('https://nangereverify.com.ng/api/v1/nin/personalization/status');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'tracking_id' => '7GH2K9LM3PQ8R1T',
]),
CURLOPT_TIMEOUT => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);
if ($result['success']) {
print_r($result['data']);
} else {
echo 'Error: ' . $result['message'];
}const res = await fetch('https://nangereverify.com.ng/api/v1/nin/personalization/status', {
method: 'POST',
headers: {
Authorization: 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
"tracking_id": "7GH2K9LM3PQ8R1T"
}),
});
const result = await res.json();
if (result.success) console.log(result.data);
else console.error('Error:', result.message);import requests
result = requests.post(
"https://nangereverify.com.ng/api/v1/nin/personalization/status",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={
"tracking_id": "7GH2K9LM3PQ8R1T"
},
timeout=60,
).json()
if result["success"]:
print(result["data"])
else:
print("Error:", result["message"])Errors use the same JSON shape with "success": false. You are never charged for an error, and a provider failure after charging is refunded automatically.
| HTTP | Meaning | Charged? |
|---|---|---|
| 200 | Success (or accepted and processing) | Yes |
| 400 | Invalid or missing parameters | No |
| 401 | Missing, invalid or revoked API key | No |
| 402 | Insufficient wallet balance | No |
| 403 | IP not allowed for this key, or API access off | No |
| 404 | Request not found (status endpoints) | No |
| 422 | Provider could not complete it — data.refunded: true | Refunded |
| 429 | Too many requests for your key | No |
| 503 | Busy — retry after data.retry_after seconds | No |
{
"success": false,
"message": "Insufficient wallet balance.",
"data": {
"balance": 150,
"amount": 200
}
}No — as long as you send the same client_ref. We return the first result and do not charge again. Always send a unique client_ref (your order ID) per order.
Validation errors are never charged. If the request was charged and the provider then fails, the amount is refunded to your wallet automatically and the response shows refunded: true.
Status checks are free. Each request is refreshed at most once a minute; checking more often returns the last known status. Every 5 minutes from a cron job is ideal.
Yes. In the API Portal add your server IP addresses. Calls from any other IP get 403. You can also regenerate the key if it leaks.
No. Call it only from your own server, so your API key is never exposed in browser JavaScript or an app.
Join our WhatsApp support group and include the reference from the response.