Lookup BVN

The Lookup BVN endpoint returns details of a particular BVN

πŸ“˜

NOTE

There are two payload responses for this endpoint based on the details returned

  • Basic
  • Advanced

BVN Basic

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": "25-May-1901",
        "phone_number1": "08012345678",
        "image": "BASE 64 IMAGE"
    }
}

BVN Advanced

Request

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

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": "25-May-1901",
        "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"
    }
}

Did this page help you?