Bank Verification Number (BVN)

Please note that when using your test key, Our test persona is John Doe and his Bank Verification Number as 10000000001. Hence all matching done with your test keys with details other than that of our Test Persona would simulate a failed identity matching. 
post
https://vapi.verifyme.ng
/v1/verifications/identities/bvn/:ref
Verify BVN
​
Sample Request
Curl
1
curl --location --request POST 'https://vapi.verifyme.ng/v1/verifications/identities/bvn/10000000001' \
2
--header 'Authorization: Bearer <your secret key>' \
3
--header 'Content-Type: application/json' \
4
--data-raw '{
5
    "firstname":"John",
6
    "lastname":"Doe",
7
    "phone":"080000000000",
8
    "dob":"04-04-1944"
9
}'
Copied!
Response Payloads
We have 2 types of payload responses for bvn verifications 
Premium 
Basic
basic response
premium response
1
{
2
   "status": "success",
3
    "data": {
4
        "bvn": "22515263226",
5
        "firstname": "JOHN",
6
        "lastname": "DOE",
7
        "middlename": "JAMES",
8
        "gender": "Male",
9
        "phone": "08100000000",
10
        "birthdate": "31-05-2000", 
11
        "photo": "<base64 image>",
12
         "fieldMatches": {
13
            "firstname": false,
14
            "lastname": false
15
        }
16
    }
17
}
Copied!
1
{
2
  "status": "success",
3
  "data": {
4
    "bvn": 10000000001,
5
    "firstname": "John",
6
    "lastname": "Doe",
7
    "middlename": "Jane"
8
    "phone": "08066676673",
9
    "gender": "female"
10
    "birthdate": "17/01/1988",
11
    "photo": "Base64 Encoded",
12
    "maritalStatus": "Single",
13
    "lgaOfResidence": "Surulere",
14
    "lgaOfOrigin": "Ijebu ode",
15
    "residentialAddress": "1 jameson street",
16
    "stateOfOrigin": "Ogun State",
17
    "enrollmentBank": "058",
18
    "enrollmentBranch": "BODIJA",
19
    "nameOnCard": "JOHN DOE",
20
    "title": "Mr",
21
    "levelOfAccount": "Level 2 - Medium Level Accounts",
22
     "fieldMatches":{
23
        "firsname":false,
24
        "lastname":false,
25
        "dob":false
26
    }
27
  } 
28
}
Copied!

general - Previous

About Verifications

Next - Identity verifications

Corporate Affairs Commission

Last modified 3mo ago

Copy link

Contents

post

Verify BVN