BVN (Basic)

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

{{baseUrl}}/v1/ng/identities/bvn-basic/{idNumber}

Path Parameter

Parameter	Type	Description
idNumber (REQUIRED)	string	Bank Verification Number

Request Body

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

This endpoint will return a snapshot of the bio-data information captured.To conduct an actual test

Response Sample

{
    "id": 15*7,
    "applicant": {
        "firstname": "Bunch",
        "lastname": "Dillon"
    },
    "summary": {
        "bvn_check": {
            "status": "EXACT_MATCH",
            "fieldMatches": {
                "firstname": true,
                "lastname": true
            }
        }
    },
    "status": {
        "state": "complete",
        "status": "verified"
    },
    "bvn": {
        "bvn": "95888168924",
        "firstname": "Bunch",
        "lastname": "Dillon",
        "birthdate": "07-07-1995",
        "gender": "Male",
        "phone": "08000000000",
        "photo": "/9j/4AAQSkZJRgABAgAAAQABAAD/***/wCpiNUFoooEf//Z"
    }
}