Nigeria π³π¬
Validate BVN
The BVN Match service allows you to verify that an account number, first name, last name and middle name of a user matches their BVN.
Request
[GET]
{{baseUrl}}/api/v1/kyc/bvn
Header
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
Parameters | Type | Description | |
---|---|---|---|
bvn * | string | A valid bvn | required |
first name | string | first name of bvn holder | optional |
last name | string | last name of bvn holder | optional |
dob | string | date of birth of bvn holder in yyyy-mm-dd | optional |
Sample response
[200]
{
"entity": {
"bvn": {
"value": "23456789012",
"status": true
},
"first_name": {
"confidence_value": 100,
"status": true
}
}
}
[400]
{
"error": "BVN not found"
}
Test Credentials for Sandbox
Kindly use this Test BVN in sandbox Environment
bvn = 22222222222
Was this page helpful?