LumiID API Docs

BVN API Overview

The BVN (Bank Verification Number) API by LumiID enables developers to securely verify and retrieve detailed user information using a valid BVN. It ensures identity verification compliance and seamless integration for fintech, KYC, and identity platforms.

Authentication

All BVN API requests require authentication via your unique Bearer Token in the request headers. 

Authorization: Bearer YOUR_API_KEY

Endpoints

1. Basic BVN Verification

The Basic BVN endpoint returns essential BVN verification data such as full name, date of birth, and phone number. 

POST /api/v1/bvn/basic/

Headers:

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Request Body:

{
  "bvn": "22123456789"
}

Sample Response:

{
  "status": "success",
  "data": {
    "bvn": "22123456789",
    "first_name": "Emmanuel",
    "last_name": "Nzorov",
    "date_of_birth": "2003-08-15",
    "phone_number": "08012345678"
  }
}

2. Premium BVN Verification

The Premium BVN endpoint provides full user details, including image data, addresses, and linked accounts for advanced verification. 

POST /api/v1/bvn/premium/

Headers:

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Request Body:

{
  "bvn": "22123456789"
}

Sample Response:

{
  "status": "success",
  "data": {
    "bvn": "22123456789",
    "first_name": "Emmanuel",
    "last_name": "Nzorov",
    "middle_name": "Tersugh",
    "date_of_birth": "2003-08-15",
    "phone_number": "08012345678",
    "registration_date": "2020-04-11",
    "enrollment_bank": "GTBank",
    "image": "https://lumiid.com/media/bvn_photos/22123456789.jpg",
    "address": "No. 5 Old GRA, Gboko, Benue State"
  }
}

Error Responses

The API returns standardized error messages for invalid BVNs, authentication failures, or missing parameters. 

{
  "status": "error",
  "message": "Invalid BVN or data not found."
}

Pricing

  • Basic BVN: ₦50 per verification
  • Premium BVN: ₦100 per verification