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

Headers

Name	Type	Description
authorization*	String	SECRET_KEY

Request Body

Name	Type	Description
verify_type*	String	e.g basic, premium, platinum
bvnno*	String	11 digit number of the BVN

200: OK

{
  "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

curl --location 'https://api.1app.online/v1/bvnkyc' \
--header 'SECRET_KEY: BEARER SECRET_KEY' \
--data '{
    "verify_type": "platinum",
    "bvnno": "12323444556"
}'

NodeJS

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);
});

PHP - cURL

$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;

Dart

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);
}

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"
  }
}