Production Ready REST API

NUBAN KYC API Reference

Instant verification of BVN, NIN, Bank Account Name, and Driver's License for your Nigerian applications.

Base URL

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

Authentication

Send your API key in the header:
Authorization: your_api_key_here
Content-Type: application/json

Available Endpoints

GET /api/v1/bvn-data

BVN Verification

Get full BVN data of any user in Nigeria

₦150
Example Request
https://api-kyc.nuban.com.ng/api/v1/bvn-data?bvn_no=12345678901
Query parameters: ?bvn_no=12345678901
Example Response
{
  "status": "success",
  "data": {
    "bvn": "12345678901",
    "first_name": "Chinaza",
    "last_name": "Okoro",
    "phone": "08034567890",
    "dob": "1995-05-12",
    "gender": "Female"
  }
}
GET /api/v1/nin-data

NIN Verification

Get NIN data including user photograph

₦200
Example Request
https://api-kyc.nuban.com.ng/api/v1/nin-data?nin_no=12345678901
Query parameters: ?nin_no=12345678901
Example Response
{
  "status": "success",
  "data": {
    "nin": "12345678901",
    "full_name": "Emmanuel Chukwudi Adebayo",
    "address": "12 Adeola Odeku, Victoria Island",
    "dob": "1992-11-03",
    "photo": "base64_or_url"
  }
}
GET /api/v1/bank-name

Bank Account Name

Resolve bank account number to verified account name

₦5
Example Request
https://api-kyc.nuban.com.ng/api/v1/bank-name?account_no=0123456789&bank_code=058
Query parameters: ?account_no=0123456789&bank_code=058
Example Response
{
  "status": "success",
  "data": {
    "account_number": "0123456789",
    "bank_code": "058",
    "account_name": "ADEBAYO EMMANUEL CHUKWUDI"
  }
}
POST /api/v1/driver-license

Driver's License

Verify Driver's License details

₦250
Example Request
POST https://api-kyc.nuban.com.ng/api/v1/driver-license
Query parameters: JSON Body
Example Response
{
  "status": "success",
  "data": {
    "id_no": "DL123456789",
    "full_name": "Fatima Yusuf",
    "expiry_date": "2028-08-15",
    "class": "B"
  }
}

Error Responses

401
Invalid or missing API key
400
Missing or invalid parameters
429
Rate limit exceeded
402
Insufficient wallet balance
Need help integrating? Contact support@nuban.com.ng
All endpoints return JSON.