Query BVN

This endpoint validates BVN(s) and returns the BVN holder's details, such as name, date of birth etc. The service cost at standard BVN charges of N35 (Naira) per query on the user's app wallet.

To query BVN(s), you must provide an <X-App-Wallet-Access-Token> Please, see the authentication section on how to obtain <X-App-Wallet-Access-Token>.

Query BVN

GET https://api.console.staging-api.eyowo.com/v1/queries/bvn?bvn=

Query Parameters

Name	Type	Description
bvn	number	valid BVN number for querying

Headers

Name	Type	Description
X-App-Key	string	X-App-Key
X-App-Wallet-Access-Token	string	X-App-Wallet-Access-Token

200

{
    "success": true,
    "data": {
        "firstName": "DELE",
        "surname": "AHMED",
        "mobileNumber": "07088605494",
        "middleName": "CHINEDU",
        "dateOfBirth": "23-Feb-84",
        "responseMessage": "SUCCESSFUL"
    }
}