Production Ready REST API

NUBAN KYC API

Instant verification of BVN, NIN, and Phone Number for your Nigerian applications.

View Full Postman Collection

Base URL

https://api-kycdata.nuban.com.ng

Authentication

Add your API key to every request header:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Available Endpoints

GET /api/bvn-data

BVN Verification

Get full Bank Verification Number details — name, phone, DOB, enrollment bank and more.

₦150 / call
Example Request
GET https://api-kycdata.nuban.com.ng/api/bvn-data?bvn_no=12345678901

Query parameter: bvn_no

Example Response
{
  "status": true,
  "message": "Verification Successful",
  "data": {
    "firstname": "Chinaza",
    "lastname": "Okoro",
    "bvn": "12345678901",
    "dob": "1995-05-12",
    "phone": "08034567890",
    "gender": "Female",
    "enrollment_bank": "GTBank",
    "state_of_origin": "Anambra",
    "billing": {
      "currency": "NGN",
      "verification_fee": 150,
      "available_credits": 2850
    }
  }
}
GET /api/nin-data

NIN Verification

National Identification Number lookup with photograph, address, and biometric-linked data.

₦200 / call
Example Request
GET https://api-kycdata.nuban.com.ng/api/nin-data?nin_no=12345678901

Query parameter: nin_no

Example Response
{
  "status": true,
  "message": "Verification Successful",
  "data": {
    "firstname": "Emmanuel",
    "surname": "Adebayo",
    "nin": "12345678901",
    "birthdate": "1992-11-03",
    "gender": "Male",
    "residence_address": "12 Adeola Odeku, Lagos",
    "photo": "<base64_image>",
    "billing": {
      "currency": "NGN",
      "verification_fee": 200,
      "available_credits": 2650
    }
  }
}
GET /api/phone-data

Phone Verification

Resolve any Nigerian mobile number to the owner's name, NIN, gender, and carrier details.

₦120 / call
Example Request
GET https://api-kycdata.nuban.com.ng/api/phone-data?phone_no=08012345678

Query parameter: phone_no

Example Response
{
  "status": true,
  "message": "Verification Successful",
  "data": {
    "firstName": "Fatima",
    "surname": "Yusuf",
    "phoneNumber": "08012345678",
    "gender": "Female",
    "nin": "98765432101",
    "billing": {
      "currency": "NGN",
      "verification_fee": 120,
      "available_credits": 2530
    }
  }
}

Error Responses

401 Invalid or missing API key
400 Missing or invalid query parameter
429 Rate limit exceeded — slow down requests
500 Insufficient wallet balance

Wallet Endpoints

GET /api/balance Get your current credit balance
GET /api/history Get last 50 wallet transactions
POST /topup-api-wallet Initiate a wallet top-up via Flutterwave
Need help integrating? support@nuban.com.ng
All endpoints return JSON.