BVN 2.0

get details of a Bank Verification number

Test data: 54651333604

Get BVN details

POST https://api.myidentitypay.com/api/v2/biometrics/merchant/data/verification/bvn

This endpoint allows you to get details of a BVN.

Headers

Name	Type	Description
x-api-key*	string	<your secret key>
app-id*	String	<your app id>

Request Body

Name	Type	Description
number*	string	bank verification number

200 BVN details successfully retrieved.

{
    "status": true,
    "response_code":"00",
    "detail": "Verification Successfull",
    "bvn_data": {
        "firstName": "",
        "middleName": "",
        "lastName": "",
        "dateOfBirth": "",
        "phoneNumber1": "",
        "phoneNumber2": "",
        "registrationDate":"",
        "enrollmentBank": "",
        "enrollmentBranch": "",
        "email": "",
        "gender": "",
        "levelOfAccount": "",
        "lgaOfOrigin": "",
        "lgaOfResidence": "",
        "maritalStatus": "",
        "nin": "",
        "nameOnCard": "",
        "nationality": "",
        "residentialAddress": "",
        "stateOfOrigin": "",
        "stateOfResidence": "",
        "title": "",
        "watchListed": "",
        "bvn": "",
        "base64Image": "user image(base64 format)"
        },
    "verification": {
        "status": "",
        "reference": ""
    }
}