BVN (Premium)

Verify a customer's identity using their Bank Verification Number (BVN) through the Nigeria Inter-Bank Settlement System (NIBSS).

To verify BVN Premium

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

Path Parameter

POST ParametersTypeDescription
bvnNumber
(REQUIRED)
string Bank Verification Number

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

Response Sample

POST ParametersTypeDescription
firstname
(REQUIRED)
stringFirst Name
lastname
(REQUIRED)
stringLast Name
dob
(OPTIONAL)
dateStringDate Of Birth(YYYY-MM-DD)
phone
(OPTIONAL)
stringPhone Number
email
(OPTIONAL)
stringEmail Address
gender
(OPTIONAL)
stringGender
{
    "id": 1**5,
    "applicant": {
        "firstname": "John",
        "lastname": "Doe"
    },
    "summary": {
        "bvn_check": {
            "status": "EXACT_MATCH",
            "fieldMatches": {
                "firstname": true,
                "lastname": true
            }
        }
    },
    "status": {
        "state": "complete",
        "status": "verified"
    },
    "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"
    }
}