BVN Check
This endpoint helps check for the validity of BVN and returns its details.
BVN check can be done in 2 modes; Basic and Premium BVN verification.
Basic Mode This mode only returns the basic information about the BVN e.g. first name, last name, middle name, phone number
Premium Mode This mode returns comprehensive information about the BVN e.g. first name, last name, middle name, full name, phone number, email, address, dob, marital status, origin, photo
POST
https://api.oneappgo.com/v1/bvnkyc
Headers
Name
Type
Description
authorization*
String
SECRET_KEY
Request Body
Name
Type
Description
verify_type*
String
e.g basic, premium
bvnno*
String
11 digit number of the BVN
{
"status": true,
"responseCode": "01",
"msg": "Verified",
"data": {
"title": "Mr",
"fullname": "AMAD JOHN CKUKWU",
"customeremail": "",
"gender": "male",
"dob": "01-02-1956",
"phone_number": "09012345678",
"alternate_phoneno": "08012345678",
"enrollmentBank": "",
"enrollmentBranch": "",
"state_origin": "",
"residence": "Yola State",
"address": "2, Iwajowa street, Agugu",
"country": "nigeria",
"nin": "",
"level_of_account": "Level 3 - High Level Accounts",
"watchlisted": false,
"photo": "BASE64 ENCODED"
}
}
curl --location 'https://api.1app.online/v1/bvnkyc' \
--header 'SECRET_KEY: BEARER SECRET_KEY' \
--data '{
"verify_type": "platinum",
"bvnno": "12323444556"
}'
Sample Response
{
"status": true,
"responseCode": "01",
"msg": "Verified",
"data": {
"title": "Mr",
"fullname": "AMAD JOHN CKUKWU",
"customeremail": "",
"gender": "male",
"dob": "01-02-1956",
"phone_number": "09012345678",
"alternate_phoneno": "08012345678",
"enrollmentBank": "",
"enrollmentBranch": "",
"state_origin": "",
"residence": "Yola State",
"address": "2, Iwajowa street, Agugu",
"country": "nigeria",
"nin": "",
"level_of_account": "Level 3 - High Level Accounts",
"watchlisted": false,
"photo": "BASE64 ENCODED"
}
}
Last updated
Was this helpful?