Comment on page
BVN Check
This endpoint helps check for the validity of BVN and returns its details.
BVN check can be done in 3 modes; Basic, Premium and Platinum 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, phone number, email, address, dob
- Platinum Mode This returns updated and comprehensive details of the BVN e.g. marital status, origin, first name, last name, middle name, full name, phone number, email, address, dob, photo, etc.
post
https://api.oneappgo.com/v1/bvnkyc
Parameters
Header
authorization*
SECRET_KEY
Body
verify_type*
e.g basic, premium, platinum
bvnno*
11 digit number of the BVN
Responses
200: OK
cURL
NodeJS
PHP - cURL
Dart
curl --location 'https://api.1app.online/v1/bvnkyc' \
--header 'SECRET_KEY: BEARER SECRET_KEY' \
--data '{
"verify_type": "platinum",
"bvnno": "12323444556"
}'
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://api.1app.online/v1/bvnkyc',
'headers': {
'SECRET_KEY': 'BEARER SECRET_KEY'
},
body: '{"verify_type": "platinum", "bvnno": "12323444556"}'
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api.1app.online/v1/bvnkyc',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"verify_type": "platinum",
"bvnno": "12323444556"
}',
CURLOPT_HTTPHEADER => array(
'SECRET_KEY: BEARER SECRET_KEY'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
var headers = {
'SECRET_KEY': 'BEARER SECRET_KEY'
};
var request = http.Request('POST', Uri.parse('https://api.1app.online/v1/bvnkyc'));
request.body = '''{\r\n "verify_type": "platinum",\r\n "bvnno": "12323444556"\r\n}''';
request.headers.addAll(headers);
http.StreamedResponse response = await request.send();
if (response.statusCode == 200) {
print(await response.stream.bytesToString());
}
else {
print(response.reasonPhrase);
}
{
"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 modified 2mo ago