Lookup BVN

The Lookup BVN endpoint returns details of a particular BVN

Request

{{baseUrl}}/api/v1/kyc/bvn/full

Headers

ParameterTypeDescription
AppIdstringyou would need to create an app to get your app ID
Authorizationstringpublic 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

ParameterTypeDescription
AppIdstringyou would need to create an app to get your app ID
Authorizationstringpublic 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