Resolve BVN

Learn how to get a Know Your Customer (KYC) profile from a customer's Bank Verification Number (BVN)

Introduction

The Resolve BVN service helps you build a KYC profile for a Nigeria-based customer using their BVN.

This service has two tiers: Standard and Premium. The Premium tier provides all the information in the Standard tier, as well as more granular information for a more detailed KYC profile.

Pricing
BVN Resolve Standard costs N10 per successful call while BVN Resolve Premium costs N15 per successful call.

Information Provided

Here's a side by side comparison of the information provided by both tiers.

BVN Resolve StandardBVN Resolve Premium
First name First name
Last name Last name
Phone number Phone number
Date of birth Date of birth
      – Image
      – Marital Status
      – Gender
      – Nationality
      – State and LGA of origin
      – Residential Address
      – Enrollment Bank
      – Name on card

BVN Resolve Standard

The BVN Resolve Standard is useful for when you need basic KYC information from a customer's BVN.

Show Response
1curl https://api.paystack.co/bank/resolve_bvn/:BVN
2-H "Authorization: Bearer YOUR_SECRET_KEY"
3-X GET
1{
2 "status": true,
3 "message": "BVN resolved",
4 "data": {
5 "first_name": "LARRY",
6 "last_name": "JAMES",
7 "dob": "30-Jan-60",
8 "formatted_dob": "1960-01-30",
9 "mobile": "08012345678",
10 "bvn": "xxxxxxxxxxx"
11 },
12 "meta": {
13 "calls_this_month": 1,
14 "free_calls_left": 9
15 }
16}

Pricing
BVN Resolve Standard costs N10 per successful call. You get 10 free requests per month. After exhausting the 10 free requests, registered businesses will have to top up your Paystack balance.

BVN Resolve Premium

BVN Resolve Premium is best suited for when your business needs a more detailed profile from a customer's BVN.

Show Response
1curl https://api.paystack.co/identity/bvn/resolve/:BVN
2-H "Authorization: Bearer YOUR_SECRET_KEY"
3-X GET
1{
2 "status": true,
3 "message": "BVN resolved",
4 "data": {
5 "title": "Mr",
6 "first_name": "JOHN",
7 "middle_name": "MUKITE",
8 "last_name": "NAMEME",
9 "name_on_card": "MUKITE NAMEME",
10 "marital_status": "Married",
11 "dob": "17-Jun-80",
12 "formatted_dob": "1980-06-17", // YYYY-MM-DD
13 "mobile": "08091111111",
14 "mobile2": "08090000000",
15 "registration_date": "24-Dec-16",
16 "formatted_registration_date": "2016-12-24",
17 "bvn": "00000000000",
18 "gender": "Male",
19 "lga_of_origin": "Ilesa West",
20 "state_of_origin": "Osun State",
21 "residential_address": "126 Joel Ogunnaike St Ikeja GRA, Lagos",
22 "lga_of_residence": "Ikeja",
23 "nationality": "Nigeria",
24 "email": "[email protected]",
25 "is_blacklisted": false,
26 "enrollment_bank": {
27 "name": "First Bank of Nigeria",
28 "code": "011",
29 "enrollment_branch": "IKEJA BRANCH"
30 },
31 "level_of_account": "Level 2 - Medium Level Accounts",
32 "nin": "",
33 "base_64_image": "Base_64_Encoded_Image=="
34 },
35 "meta": {
36 "calls_this_month": 12,
37 "free_calls_left": 0
38 }
39}

This is best suited for businesses in these industries:

  • Lending
  • Savings
  • Betting
  • Remittance and other financial services

Pricing
BVN Resolve Premium costs N15 per successful call. You'll get 10 free requests per month. After exhausting the 10 free requests, registered businesses will have to top up your Paystack balance.