Identity API · Nigeria

Resolve an identity in one request.

Verify NIN and BVN in real time — by number, phone, or demographics. Build KYC, customer onboarding, and fraud checks on one API: authenticate, send JSON, get a structured response. Pay per request from your wallet.

Get your API key → Try the live sandbox
9 endpointsx-api-key authfrom ₦100 / request
Identity Scan POST /api/nin-verification
NIN
•••••••••••
First name
—
Surname
—
Gender
—
Date of birth
—
State
—
Phone
—
Verified
reportID: ········
Endpoints

One base URL. Every verification you need.

Send a POST with your API key and "consent": true. Click an endpoint to see its exact request and response.

POSThttps://veripine.com/api/nin-verification
Request

        
Response

        

      

    

  







  

    

      Use cases
      
Built for KYC, onboarding & fraud prevention

      
The same verification endpoints power identity workflows across fintech, lending, and agent networks in Nigeria.

    

    

      
KYC & identity verification
Confirm a customer’s NIN or BVN instantly to meet Know-Your-Customer requirements before you open an account.

      
Customer onboarding
Validate identity during sign-up for a fast, frictionless digital onboarding flow with fewer drop-offs.

      
Fintech & lending
Verify borrowers before disbursing loans or opening wallets — reduce default risk and satisfy regulators.

      
Agent & reseller onboarding
Vet agents and resellers at scale before granting access to your platform or float.

      
Fraud & AML prevention
Cross-check identity data to detect duplicate, stolen, or synthetic identities before they reach your books.

      
Records & compliance
Generate and store verified identity records for audit trails and regulatory reporting.

    

  







  

    

      Get started
      
From sign-up to first call in minutes

      
No sales calls, no monthly fees. Everything runs through the API — register, fund, integrate.

    

    

      
STEP 01
Create your account
Register and open your developer dashboard.

      
STEP 02
Fund your wallet
Top up your prepaid balance. Requests are billed from it — no subscription.

      
STEP 03
Generate a key & call
Create an API key, send requests with x-api-key, get JSON back.

    

  







  

    

      Integration
      
Copy, paste, verify

      
A real NIN verification call, ready for your stack. Swap in your key and go.

    

    

      

        
        
        
        
      


curl -X POST https://veripine.com/api/nin-verification \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "nin": "12345678901",
    "consent": true
  }'


$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://veripine.com/api/nin-verification",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_POSTFIELDS => json_encode([
        "nin" => "12345678901",
        "consent" => true
    ]),
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
        "x-api-key: YOUR_API_KEY"
    ],
]);
$response = json_decode(curl_exec($curl), true);
curl_close($curl);


const res = await fetch("https://veripine.com/api/nin-verification", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY"
  },
  body: JSON.stringify({ nin: "12345678901", consent: true })
});
const data = await res.json();


import requests

res = requests.post(
    "https://veripine.com/api/nin-verification",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={"nin": "12345678901", "consent": True},
    timeout=30,
)
print(res.json())

    

  







  

    

      Pricing
      
Pay per request. Nothing else.

      
Fund a wallet and spend it only on successful requests. Free account, no minimums, keep your keys forever.

    

    

      
/api/bvn-verificationVerify a BVN by number₦100

      
/api/nin-verificationVerify a NIN by number₦150

      
/api/bvn-phoneSearch BVN by phone number₦150

      
/api/nin-phoneSearch NIN by phone number₦200

      
/api/nin-trackingSearch NIN by tracking ID₦200

      
/api/nin-demographySearch NIN by demographic data₦250

      
/api/balanceCheck account balanceFree

    

    
Prices shown are starting rates. NIN modification & validation orders available from ₦6,000.

  







  

    
FAQ
Answers for builders

    

      
How do I authenticate?
Send your API key in the x-api-key header, or as an Authorization: Bearer token. Generate your key in the dashboard after you register.

      
Is consent required?
Yes. Every verification request must include "consent": true. Requests without it are rejected with a 400 error — this keeps you compliant with data-protection requirements.

      
How does billing work?
Wallet-based, pay-as-you-go. Fund your wallet in advance; each successful request deducts that endpoint's fee. No subscriptions, no minimums. Verifications start from ₦100.

      
Can I test before writing code?
Yes — the live API sandbox lets you validate your key and try every endpoint in the browser, then copy working code in cURL, PHP, JavaScript, or Python.

      
Can I use Veripine for KYC and customer onboarding?
Yes. Real-time NIN and BVN verification is ideal for KYC and digital onboarding — call the API during sign-up to confirm a customer’s identity instantly and stay compliant.

      
Is Veripine suitable for fintechs and lenders?
Yes. Verify identity before opening accounts or disbursing loans to reduce fraud and meet regulatory obligations, all from one API.

      
What does a response look like?
Clean JSON: a status, a reportID, a message, and a data object with the verified fields (names, gender, DOB, state, photo, and more).

    

  







  

    
Build with Veripine today

    
Create your account, fund your wallet, and make your first verified request in minutes.

    Get your API key →