BVN (Premium)

Verify a customer’s identity using their Bank Verification Number (BVN) through the Nigeria Inter-Bank Settlement System (NIBSS). This premium verification tier returns the full biodata profile available for the BVN holder, offering the highest-level, most comprehensive identity dataset for risk assessment, onboarding, and compliance workflows.

To verify BVN Premium

{{baseUrl}}/v1/ng/identities/bvn-premium/{bvnNumber}

Path Parameter

POST Parameters	Type	Description
bvnNumber (REQUIRED)	string	Bank Verification Number

This endpoint will return all bio-data information captured. To conduct an actual test

Response Sample

POST Parameters	Type	Description
firstname (REQUIRED)	string	First Name
lastname (REQUIRED)	string	Last Name
dob (OPTIONAL)	dateString	Date Of Birth(YYYY-MM-DD)
phone (OPTIONAL)	string	Phone Number
email (OPTIONAL)	string	Email Address
gender (OPTIONAL)	string	Gender

{
    "id": 1**5,
    "applicant": {
        "firstname": "John",
        "lastname": "Doe"
    },
    "summary": {
        "bvn_check": {
            "status": "EXACT_MATCH",
            "fieldMatches": {
                "firstname": true,
                "lastname": true
            }
        }
    },
    "status": {
        "state": "complete",
        "status": "verified"
    },
    "insight": [  // detail of other organisations that have checked this same ID recently
        {
            "serviceCategory": "Commercial Banks",
            "insightCount": 1,
            "timeframeInMonths": 12
        },
        {
            "serviceCategory": "Digital Bank",
            "insightCount": 1,
            "timeframeInMonths": 12
        }
    ],
    "bvn": {
        "bvn": "2********95",
        "firstname": "John",
        "lastname": "Doe",
        "middlename": "Cena",
        "birthdate": "10-06-1992",
        "gender": "Male",
        "phone": "080********7",
        "photo": "/9j/4AAQS************SGz//2Q==",
        "lga_of_origin": "Ideato*****",
        "marital_status": "Single",
        "nationality": "Nigeria",
        "residential_address": "No.2 ****** Hill Benin City",
        "state_of_origin": "Imo State",
        "state_of_residence": "Edo State",
        "email": "[email protected]",
        "enrollment_bank": "04",
        "enrollment_branch": "RET SHOP****",
        "title": "Mr",
        "name_on_card": "John Doe Cena",
        "level_of_account": "Level 1 - Low Level Accounts",
        "registration_date": "31-Jul-2015",
        "watch_listed": "NO"
    }
}

Updated 2 days ago