BVN Basic

Validate a bank verification number

Our BVN Basic service enables businesses to efficiently authenticate their customers' BVN and confirm its accuracy with the stored information. The BVN validation service we offer is designed to be exceptionally user-friendly and straightforward. All you need to do is input your customer's BVN, and our system will swiftly handle the process, verifying the BVN and presenting you with a response of the user's basic information.

πŸ‘

TEST DATA

number: 54651333604

πŸ“˜

POST

{{URL}}/identitypass/verification/bvn_validation

Parameters

Header

KeyDescription
app-idYour App ID
x-api-keyYour Secret Key

Body

KeyDescription
numberBank verification number

Responses

{
    "status": true,
    "detail": "Verification Successfull",
    "response_code": "00",
    "data": {
        "firstName": "John",
        "middleName": "Doe",
        "lastName": "Jane",
        "dateOfBirth": "01-Jan-2000",
        "phoneNumber": "08012345678"
    },
    "source": "API",
    "user_info": null,
    "request_data": {
        "number": "54651333604"
    }
}

Response Description

ResponseDescription
statusIndicates that the request was successful.
detailThis field indicates the detail of the response.
response_codeRepresents the response code.
dataAn object containing details about the BVN holder.
firstNameThe first name of the BVN holder.
middleNameThe middle name of the BVN holder.
lastNameThe last name of the BVN holder.
dateOfBirthThe date of birth of the BVN holder. Format: "DD-Mon-YYYY" (e.g., "01-Jan-2000").
phoneNumberThe phone number associated with the BVN holder.
sourceIndicates the source of the verification.
user_infoInformation about the user.
request_dataThe data provided in the original request for verification.
numberThe BVN number that was submitted for verification.