Request

[GET]
{{baseUrl}}/api/v1/kyc/bvn
ParameterTypeDescription
AppIdstringyou would need to create an app to get your app ID
Authorizationstringpublic secret key e.g prod_sk_1T1eSavlZxy02OT3OWlvbxK4G

Query parameters

ParametersTypeDescription
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