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

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

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

PreviousCreate MXN Account NextNIN Checks

Last updated 1 year ago

hashtagHeaders

hashtagRequest Body

hashtagSample Response

Headers

Request Body

Sample Response