Verify Bank Verification Number (BVN Premium)

BVN Verification

POST {{baseurl}}/v2/api/identity/ng/bvn-premium

This endpoint allows you to perform different types of BVN verifications.

Headers

Name
Type
Description

token*

String

API secret token

Request Body

Name
Type
Description

id*

String

valid BVN

isSubjectConsent*

Boolean

Indicate subject has given consent. Must be true

validation

Object

Validation Object

data

Object

Validation data object

lastName

String

lastname to compare against ID

firstName

String

firstname to compare against ID

dateOfBirth

String

date of birth to compare against ID

selfie

Object

Selfie validation object

image

String

Selfie image to compare against ID

metadata

Object

Metadata object. Any valid object can be passed here. It gets returned as is.

premiumBVN

Boolean

Whether to perform a premium

Default value: false

BVN Verification

The BVN verification feature is used to verify that a provided BVN number exists in the government database. It shows the full information of the BVN holder; Update: We are excited to inform you that our BVN service now includes the retrieval of gender, address and watchlist information. You can get it by adding the "premiumBVN": true

BVN Facial Matching

The BVN Facial matching feature is used to verify that a BVN is valid and that the image provided matches the image in the government database. The feature also returns a confidence score of the Facial matching.

BVN Validation

BVN Validation is used to verify a Passport and also compare given data parameters against the data present in the government database. For example, a FIrstname and Lastname can be provided and this will validate as true or false as to whether it matches with the names in the database or not

BVN Advanced Search is used to verify a BVN number and also returns the NIN number of the candidate;

BVN Full Sample Request

Last updated

Was this helpful?