​
Request

[GET]
{{baseUrl}}/api/v1/kyc/bvn
HeaderTypeDescription
AppIdstringCreate an app to get your app ID on dashboard here
Authorizationstringpublic secret key

​
Query parameters

ParametersTypeDescriptionRequired
bvn *stringA valid bvnrequired
first namestringfirst name of bvn holderoptional
last namestringlast name of bvn holderoptional
dobstringdate of birth of bvn holder in yyyy-mm-ddoptional

​
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

​
Request

[GET]
{{baseUrl}}/api/v1/kyc/bvn
HeaderTypeDescription
AppIdstringCreate an app to get your app ID on dashboard here
Authorizationstringpublic secret key

​
Query parameters

ParametersTypeDescriptionRequired
bvn *stringA valid bvnrequired
first namestringfirst name of bvn holderoptional
last namestringlast name of bvn holderoptional
dobstringdate of birth of bvn holder in yyyy-mm-ddoptional

​
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