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
| Key | Description |
|---|---|
| app-id | Your App ID |
| x-api-key | Your Secret Key |
Body
| Key | Description |
|---|---|
| number | Bank 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
| Response | Description |
|---|---|
| status | Indicates that the request was successful. |
| detail | This field indicates the detail of the response. |
| response_code | Represents the response code. |
| data | An object containing details about the BVN holder. |
| firstName | The first name of the BVN holder. |
| middleName | The middle name of the BVN holder. |
| lastName | The last name of the BVN holder. |
| dateOfBirth | The date of birth of the BVN holder. Format: "DD-Mon-YYYY" (e.g., "01-Jan-2000"). |
| phoneNumber | The phone number associated with the BVN holder. |
| source | Indicates the source of the verification. |
| user_info | Information about the user. |
| request_data | The data provided in the original request for verification. |
| number | The BVN number that was submitted for verification. |
Updated 9 months ago