Lookup BVN: Bank Verification Number Details

Retrieve identity and account details for a Nigerian Bank Verification Number. Returns name, phone, DOB, and linked account information from the BVN registry.

BVN Basic

[GET]

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

Header

Header	Type	Description
AppId	string	Create an app to get your app ID on dashboard here
Authorization	string	Private/secret key. Use <key> not Bearer <key>

Query parameters

Parameter	Type	Description	Required
bvn *	string	A valid bvn	required

Sample response

Response

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

Response Fields

Field	Type	Description
entity	object	Contains the BVN holder’s identity details
entity.bvn	string	Bank Verification Number
entity.first_name	string	First name of the BVN holder
entity.last_name	string	Last name of the BVN holder
entity.middle_name	string	Middle name of the BVN holder
entity.gender	string	Gender of the BVN holder
entity.date_of_birth	string	Date of birth in YYYY-MM-DD format
entity.phone_number1	string	Primary phone number linked to the BVN
entity.image	string	Base64-encoded photograph of the BVN holder
entity.phone_number2	string	Secondary phone number linked to the BVN

BVN Advanced

[GET]

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

Header

Header	Type	Description
AppId	string	Create an app to get your app ID on dashboard here
Authorization	string	Private/secret key. Use <key> not Bearer <key>

Query parameters

Parameter	Type	Description	Required
bvn *	string	A valid bvn	required

Sample response

Response

{
  "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": "[e-mail]",
        "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",
        "phone_number2": "08012345678",
        "registration_date": "",
        "residential_address": "",
        "state_of_origin": "OSUN",
        "state_of_residence": "LAGOS",
        "title": "MISS",
        "watch_listed": "NO"
    }
}

Response Fields

Field	Type	Description
entity	object	Contains the BVN holder’s identity details
entity.bvn	string	Bank Verification Number
entity.first_name	string	First name of the BVN holder
entity.last_name	string	Last name of the BVN holder
entity.middle_name	string	Middle name of the BVN holder
entity.gender	string	Gender of the BVN holder
entity.date_of_birth	string	Date of birth in YYYY-MM-DD format
entity.phone_number1	string	Primary phone number linked to the BVN
entity.image	string	Base64-encoded photograph of the BVN holder
entity.email	string	Email address of the BVN holder
entity.enrollment_bank	string	Bank where the BVN was enrolled
entity.enrollment_branch	string	Branch where the BVN was enrolled
entity.level_of_account	string	Account level classification
entity.lga_of_origin	string	Local Government Area of origin
entity.lga_of_residence	string	Local Government Area of residence
entity.marital_status	string	Marital status of the BVN holder
entity.name_on_card	string	Name printed on the BVN card
entity.nationality	string	Nationality of the BVN holder
entity.phone_number2	string	Secondary phone number linked to the BVN
entity.registration_date	string	BVN registration date
entity.residential_address	string	Residential address of the BVN holder
entity.state_of_origin	string	State of origin
entity.state_of_residence	string	State of residence
entity.title	string	Title of the BVN holder (e.g., Mr, Mrs, Miss)
entity.watch_listed	string	Whether the BVN holder is on a watchlist

Test Credentials for Sandbox

Kindly use this Test BVN in sandbox Environment

bvn = 22222222222