Home Services About Contact
Login Register
Home / Developer API / Documentation
PREMIUM DEVELOPER API

API Documentation

Complete reference for all available endpoints, parameters, and response formats.

Base URLhttps://nangereverify.com.ng/api/v1
MethodPOST (GET for balance)
Content-Typeapplication/json
AuthAuthorization: Bearer API_KEY
Share API Documentation
Give your developers this public URL — it shows every endpoint without requiring login.
Get API key

Get started in 4 easy steps

Every 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.

1Get your API keyOpen the API Portal and copy your key. Keep it secret — only call the API from your server.
2Fund your walletThe API is not free. Each paid call is charged from your NANGERE wallet. Fund your wallet before you start.
3Send a requestPOST JSON to https://nangereverify.com.ng/api/v1/… with Authorization: Bearer YOUR_API_KEY.
4Read the responseCheck success. Instant services return data straight away; queued services return a reference you check with their /status endpoint.

IPE Clearance, Validation & Personalization — integration guide

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.

How it works
1. SubmitPOST to the service endpoint with a client_ref
2. Save the referenceYou get data.reference and status: processing
3. We process itUsually within minutes; some requests take longer
4. Check status (free)POST the reference to …/status at most once a minute
Request statuses
processingReceived and being worked on. You have been charged.
completedDone. The result is in data.result.
failedCould not be completed. data.refunded is true and the money is back in your wallet.
Full working example (submit + check result)
PHP
<?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.';
}
JavaScript (Node.js)
// 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);
Python
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)
01 GET Wallet Balance /balance

Check the balance of the wallet your API key is charged from. This request is free.

Free — this call is never charged
Endpoint
GET https://nangereverify.com.ng/api/v1/balance
Parameters
FieldTypeRequiredDescription
Authorizationheader YesBearer YOUR_API_KEY (or send it as X-API-Key)
Request Body
request.json
// No body — send only the Authorization header
Success Response
200 OK
{
    "success": true,
    "message": "OK",
    "data": {
        "balance": 15250,
        "currency": "NGN"
    }
}
Code Example
cURL
curl https://nangereverify.com.ng/api/v1/balance \
  -H 'Authorization: Bearer YOUR_API_KEY'
PHP
<?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'];
}
JavaScript
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);
Python
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"])
Error Responses
401 Invalid API key403 IP not allowed429 Too many requests
02 POST NIN Verification by NIN /nin/verify

Verify an 11-digit National Identification Number and get the holder's details and photo instantly.

₦150 – ₦500 (depends on variant)
Endpoint
POST https://nangereverify.com.ng/api/v1/nin/verify
Parameters
FieldTypeRequiredDescription
Authorizationheader YesBearer YOUR_API_KEY (or send it as X-API-Key)
variantstring YesSlip type, e.g. nin-premium-slip (see Variants & prices)
ninstring Yes11-digit NIN
client_refstring NoYour unique order ID (max 80 characters). Resending it returns the first result and does not charge you again
Variants & prices
variantNamePrice
nin-premium-slipPremium Slip₦200
nin-standard-slipStandard Slip₦150
nin-regular-slipRegular Slip₦150
nin-vnin-slipVNIN Slip₦500
Request Body
request.json
{
    "variant": "nin-premium-slip",
    "nin": "12345678901",
    "client_ref": "ORDER-10045"
}
Success Response
200 OK
{
    "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..."
        }
    }
}
Code Example
cURL
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
<?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'];
}
JavaScript
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);
Python
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"])
Error Responses
400 Missing params401 Invalid API key402 Insufficient balance403 IP not allowed422 Provider failed (refunded)429 Too many requests503 Service busy
03 POST NIN Verification by Phone /nin/verify

Find and verify a NIN using the phone number linked to it.

₦150 – ₦500 (depends on variant)
Endpoint
POST https://nangereverify.com.ng/api/v1/nin/verify
Parameters
FieldTypeRequiredDescription
Authorizationheader YesBearer YOUR_API_KEY (or send it as X-API-Key)
variantstring YesSlip type, e.g. nin-premium-slip
phonestring Yes11-digit phone number, e.g. 08030000000
client_refstring NoYour unique order ID (max 80 characters). Resending it returns the first result and does not charge you again
Variants & prices
variantNamePrice
nin-premium-slipPremium Slip₦200
nin-standard-slipStandard Slip₦150
nin-regular-slipRegular Slip₦150
nin-vnin-slipVNIN Slip₦500
Request Body
request.json
{
    "variant": "nin-premium-slip",
    "phone": "08030000000",
    "client_ref": "ORDER-10046"
}
Success Response
200 OK
{
    "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..."
        }
    }
}
Code Example
cURL
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
<?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'];
}
JavaScript
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);
Python
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"])
Error Responses
400 Missing params401 Invalid API key402 Insufficient balance403 IP not allowed422 Provider failed (refunded)429 Too many requests503 Service busy
04 POST NIN Verification by Demographics /nin/verify

Find and verify a NIN using first name, last name, date of birth and gender.

₦150 – ₦500 (depends on variant)
Endpoint
POST https://nangereverify.com.ng/api/v1/nin/verify
Parameters
FieldTypeRequiredDescription
Authorizationheader YesBearer YOUR_API_KEY (or send it as X-API-Key)
variantstring YesSlip type, e.g. nin-premium-slip
first_namestring YesFirst name
last_namestring YesLast name (surname)
date_of_birthstring YesDate of birth as YYYY-MM-DD
genderstring Yesmale or female
client_refstring NoYour unique order ID (max 80 characters). Resending it returns the first result and does not charge you again
Variants & prices
variantNamePrice
nin-premium-slipPremium Slip₦200
nin-standard-slipStandard Slip₦150
nin-regular-slipRegular Slip₦150
nin-vnin-slipVNIN Slip₦500
Request Body
request.json
{
    "variant": "nin-premium-slip",
    "first_name": "John",
    "last_name": "Doe",
    "date_of_birth": "1990-01-15",
    "gender": "male",
    "client_ref": "ORDER-10047"
}
Success Response
200 OK
{
    "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..."
        }
    }
}
Code Example
cURL
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
<?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'];
}
JavaScript
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);
Python
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"])
Error Responses
400 Missing params401 Invalid API key402 Insufficient balance403 IP not allowed422 Provider failed (refunded)429 Too many requests503 Service busy
05 POST BVN Verification /bvn/verify

Verify an 11-digit Bank Verification Number and get the holder's details and photo instantly.

₦200 per request
Endpoint
POST https://nangereverify.com.ng/api/v1/bvn/verify
Parameters
FieldTypeRequiredDescription
Authorizationheader YesBearer YOUR_API_KEY (or send it as X-API-Key)
variantstring YesVerification type, e.g. bvn-premium-slip (see Variants & prices)
bvnstring Yes11-digit BVN
client_refstring NoYour unique order ID (max 80 characters). Resending it returns the first result and does not charge you again
Variants & prices
variantNamePrice
bvn-full-detailsFull Details₦200
bvn-premium-slipPremium Slip₦200
Request Body
request.json
{
    "variant": "bvn-premium-slip",
    "bvn": "22234567890",
    "client_ref": "ORDER-20001"
}
Success Response
200 OK
{
    "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..."
        }
    }
}
Code Example
cURL
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
<?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'];
}
JavaScript
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);
Python
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"])
Error Responses
400 Missing params401 Invalid API key402 Insufficient balance403 IP not allowed422 Provider failed (refunded)429 Too many requests503 Service busy
06 POST IPE Clearance /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.

₦800 per request
Endpoint
POST https://nangereverify.com.ng/api/v1/nin/ipe-clearance
Parameters
FieldTypeRequiredDescription
Authorizationheader YesBearer YOUR_API_KEY (or send it as X-API-Key)
tracking_idstring YesThe 15-character NIMC Tracking ID, e.g. 7GH2K9LM3PQ8R1T
client_refstring NoYour unique order ID (max 80 characters). Resending it returns the first result and does not charge you again
This request may return status: processing. Save data.reference and check it with the matching Status endpoint. If it fails, you are refunded automatically.
Request Body
request.json
{
    "tracking_id": "7GH2K9LM3PQ8R1T",
    "client_ref": "ORDER-30001"
}
Success Response
200 OK
{
    "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"
        }
    }
}
Code Example
cURL
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
<?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'];
}
JavaScript
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);
Python
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"])
Error Responses
400 Missing params401 Invalid API key402 Insufficient balance403 IP not allowed422 Provider failed (refunded)429 Too many requests503 Service busy
07 POST IPE Clearance Status /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.

Free — this call is never charged
Endpoint
POST https://nangereverify.com.ng/api/v1/nin/ipe-clearance/status
Parameters
FieldTypeRequiredDescription
Authorizationheader YesBearer YOUR_API_KEY (or send it as X-API-Key)
referencestring NoThe reference from the submit response
tracking_idstring NoOr the Tracking ID you submitted. One of the two is required
Request Body
request.json
{
    "tracking_id": "7GH2K9LM3PQ8R1T"
}
Success Response
200 OK
{
    "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"
    }
}
Code Example
cURL
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
<?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'];
}
JavaScript
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);
Python
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"])
Error Responses
400 Missing reference401 Invalid API key404 Request not found429 Too many requests
08 POST NIN Validation /nin/validation

Submit a NIN for validation (for example after a modification, or when the NIN returns "no record found").

₦1,300 – ₦2,000 (depends on variant)
Endpoint
POST https://nangereverify.com.ng/api/v1/nin/validation
Parameters
FieldTypeRequiredDescription
Authorizationheader YesBearer YOUR_API_KEY (or send it as X-API-Key)
variantstring YesValidation type, e.g. nin-no-record-found (see Variants & prices)
ninstring Yes11-digit NIN
client_refstring NoYour unique order ID (max 80 characters). Resending it returns the first result and does not charge you again
Variants & prices
variantNamePrice
nin-no-record-foundNo Record Found₦1,300
nin-modification-validationModification Validation₦2,000
This request may return status: processing. Save data.reference and check it with the matching Status endpoint. If it fails, you are refunded automatically.
Request Body
request.json
{
    "variant": "nin-no-record-found",
    "nin": "12345678901",
    "client_ref": "ORDER-40001"
}
Success Response
200 OK
{
    "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"
        }
    }
}
Code Example
cURL
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
<?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'];
}
JavaScript
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);
Python
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"])
Error Responses
400 Missing params401 Invalid API key402 Insufficient balance403 IP not allowed422 Provider failed (refunded)429 Too many requests503 Service busy
09 POST NIN Validation Status /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.

Free — this call is never charged
Endpoint
POST https://nangereverify.com.ng/api/v1/nin/validation/status
Parameters
FieldTypeRequiredDescription
Authorizationheader YesBearer YOUR_API_KEY (or send it as X-API-Key)
referencestring NoThe reference from the submit response
ninstring NoOr the NIN you submitted. One of the two is required
Request Body
request.json
{
    "nin": "12345678901"
}
Success Response
200 OK
{
    "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"
    }
}
Code Example
cURL
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
<?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'];
}
JavaScript
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);
Python
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"])
Error Responses
400 Missing reference401 Invalid API key404 Request not found429 Too many requests
10 POST NIN Personalization /nin/personalization

Personalize a NIN with its enrolment Tracking ID.

₦250 per request
Endpoint
POST https://nangereverify.com.ng/api/v1/nin/personalization
Parameters
FieldTypeRequiredDescription
Authorizationheader YesBearer YOUR_API_KEY (or send it as X-API-Key)
tracking_idstring YesThe 15-character NIMC Tracking ID, e.g. 7GH2K9LM3PQ8R1T
client_refstring NoYour unique order ID (max 80 characters). Resending it returns the first result and does not charge you again
This request may return status: processing. Save data.reference and check it with the matching Status endpoint. If it fails, you are refunded automatically.
Request Body
request.json
{
    "tracking_id": "7GH2K9LM3PQ8R1T",
    "client_ref": "ORDER-50001"
}
Success Response
200 OK
{
    "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"
        }
    }
}
Code Example
cURL
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
<?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'];
}
JavaScript
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);
Python
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"])
Error Responses
400 Missing params401 Invalid API key402 Insufficient balance403 IP not allowed422 Provider failed (refunded)429 Too many requests503 Service busy
11 POST NIN Personalization Status /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.

Free — this call is never charged
Endpoint
POST https://nangereverify.com.ng/api/v1/nin/personalization/status
Parameters
FieldTypeRequiredDescription
Authorizationheader YesBearer YOUR_API_KEY (or send it as X-API-Key)
referencestring NoThe reference from the submit response
tracking_idstring NoOr the Tracking ID you submitted. One of the two is required
Request Body
request.json
{
    "tracking_id": "7GH2K9LM3PQ8R1T"
}
Success Response
200 OK
{
    "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"
    }
}
Code Example
cURL
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
<?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'];
}
JavaScript
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);
Python
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"])
Error Responses
400 Missing reference401 Invalid API key404 Request not found429 Too many requests
No endpoint matches your search.

Error format & status codes

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.

HTTPMeaningCharged?
200Success (or accepted and processing)Yes
400Invalid or missing parametersNo
401Missing, invalid or revoked API keyNo
402Insufficient wallet balanceNo
403IP not allowed for this key, or API access offNo
404Request not found (status endpoints)No
422Provider could not complete it — data.refunded: trueRefunded
429Too many requests for your keyNo
503Busy — retry after data.retry_after secondsNo
402 Payment Required
{
    "success": false,
    "message": "Insufficient wallet balance.",
    "data": {
        "balance": 150,
        "amount": 200
    }
}

Frequently asked questions

Will I be charged twice if I retry a request?

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.

What happens if a request fails?

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.

How often can I check a status?

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.

Can I lock my key to my server?

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.

Can I call the API from a website or mobile app directly?

No. Call it only from your own server, so your API key is never exposed in browser JavaScript or an app.

Where do I get help?

Join our WhatsApp support group and include the reference from the response.

Copied!
GEE