Lookup BVN
The Lookup BVN endpoint returns details of a particular BVN
Request
{{baseUrl}}/api/v1/kyc/bvn/full
Headers
Parameter | Type | Description |
---|---|---|
AppId | string | you would need to create an app to get your app ID |
Authorization | string | public secret key e.g prod_sk_1T1eSavlZxy02OT3OWlvbxK4G |
Query Parameters
Parameter | Type | Description | |
---|---|---|---|
bvn * | string | A valid bvn | required |
Response Sample
{
"entity": {
"bvn": "22171234567",
"first_name": "JOHN",
"last_name": "DOE",
"middle_name": "AHMED",
"gender": "Male",
"date_of_birth": "1997-05-16",
"phone_number1": "08012345678",
"image": "BASE 64 IMAGE",
"phone_number2": "08012345678"
}
}
Test Credentials for Sandbox
Kindly use this Test BVN in sandbox Environment
bvn = 22222222222
BVN Advanced
Request
{{baseUrl}}/api/v1/kyc/bvn/advance
Headers
Parameter | Type | Description |
---|---|---|
AppId | string | you would need to create an app to get your app ID |
Authorization | string | public secret key e.g prod_sk_1T1eSavlZxy02OT3OWlvbxK4G |
Query Parameters
Parameter | Type | Description | |
---|---|---|---|
bvn * | string | A valid bvn | required |
Response Sample
{
"entity": {
"bvn": "22171234567",
"first_name": "JOHN",
"last_name": "DOE",
"middle_name": "AHMED",
"gender": "Male",
"date_of_birth": "1997-05-16",
"phone_number1": "08012345678",
"image": "BASE 64 IMAGE",
"email": "[email protected]",
"enrollment_bank": "GTB",
"enrollment_branch": "IKEJA",
"level_of_account": "LEVEL 2",
"lga_of_origin": "OSOGBO",
"lga_of_residence": "IKEJA",
"marital_status": "SINGLE",
"name_on_card": "",
"nationality": "NIGERIAN",
"nin": "70123456789",
"phone_number2": "08012345678",
"registration_date": "",
"residential_address": "",
"state_of_origin": "OSUN",
"state_of_residence": "LAGOS",
"title": "MISS",
"watch_listed": "NO"
}
}
Test Credentials for Sandbox
Kindly use this Test BVN in sandbox Environment
bvn = 22222222222
Updated 5 months ago