BVN Information
Using account ID of a user you can conveniently get the Basic or Full BVN information of the user.

BASIC BVN INFORMATION

This endpoint allows developers to retrieve BASIC BVN information of an account holder by making use of the account ID.
GET Lookup BASIC BVN Information
1
{{baseUrl}}/api/v1/financial/bvn_information/basic
Copied!
Params
Curl
Response
Parameters
Type
Description
account_id required
string
Account ID
1
curl -L -X GET '{{baseUrl}}/financial/bvn_information' a\
2
-H 'Content-Type: application/json' \
3
-H 'Authorization: SECRET_KEY'
4
-H 'AppId: APP_ID'
Copied!
1
{
2
"entity": {
3
"first_name": "ISAAC",
4
"last_name": "THOMPSON",
5
"dob": "28-Jun-00",
6
"formatted_dob": "2000-06-28",
7
"mobile": "070***28116",
8
"bvn": "2246***3719"
9
}
10
}
Copied!

FULL BVN INFORMATION

This endpoint allows developers to retrieve FULL BVN information of an account holder by making use of the account ID.
GET Lookup FULL BVN Information
1
{{baseUrl}}/api/v1/financial/bvn_information/full
Copied!
Params
Curl
Response
Parameters
Type
Description
account_id required
string
Account ID
1
curl -L -X GET '{{baseUrl}}/financial/bvn_information' a\
2
-H 'Content-Type: application/json' \
3
-H 'Authorization: SECRET_KEY'
4
-H 'AppId: APP_ID'
Copied!
1
{
2
"entity": {
3
"bvn": "2245***7919",
4
"date_of_birth": "28-Jun-2000",
5
"email": "[email protected]",
6
"enrollment_bank": "058",
7
"enrollment_branch": "UNILORIN",
8
"first_name": "JOSHUA",
9
"gender": "Male",
10
"image": "/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAA.....",
11
"last_name": "ISAAC",
12
"level_of_account": "Level 2 - Medium Level Accounts",
13
"lga_of_origin": "Odo Otin",
14
"lga_of_residence": "Ilorin South",
15
"marital_status": "Single",
16
"middle_name": "THOMPSONBROWN",
17
"name_on_card": "ISAAC, THOMPSON O",
18
"nationality": "Nigeria",
19
"nin": "",
20
"phone_number1": "0708***0116",
21
"phone_number2": "",
22
"registration_date": "21-Mar-2018",
23
"residential_address": "24, OSHODI SURULERE, ILORIN",
24
"state_of_origin": "Osun State",
25
"state_of_residence": "Kwara State",
26
"title": "Mr",
27
"watch_listed": "NO"
28
}
29
}
Copied!
Last modified 6mo ago