BVN Scope

The scope of BVN is primarily to establish and maintain a unique identity for bank customers in Nigeria. It links all the accounts of a customer in different banks using the BVN as the identifier, thus providing a centralized and reliable means of identifying customers and preventing identity theft and fraud.

In summary, the BVN scope includes unique identification, KYC requirements, fraud prevention, financial inclusion, and security. It helps to improve the efficiency and security of the banking system in Nigeria.

The BVN scopes and the descriptions are captured in the table below:

Scope	Description
profile	Will get user biodata
banking_data	Will get user banks
bvn	Will get the User's Bank Verification Number
address	User's address
contact_info	User's contact info
email_address	Contains only user's electronic contact info

BVN scope Response structure

The scope response structure is obtained by passing the scope as an array to scope property in the BVN Validation Request.

The response structures are as follows:

Profile response structure

{  
  "customer_id" : "",  
  "enroll_user_name" : "",  
  "gender" : "",  
  "title" : "",  
  "surname" : "",  
  "first_name" : "",  
  "middle_name" : "",  
  "date_of_birth" : "",  
  "face_image" : "",  
  "lga_of_origin" : "",  
  "marital_status" : "",  
  "nationality" : "",  
  "nin" : "",  
  "remarks" : "",  
  "state_of_origin" : "",  
  "additional_info_1" : "",  
  "watchlisted" : "",  
}

Bank data response structure

{  
  "state_of_capture":"",  
  "lga_of_capture":"",  
  "enrollment_date":"",  
  "enroll_bank_code":"221",  
  "customer_id":"000395205",  
  "name_on_card":"",  
  "branch_name":"",  
  "watchlisted":"",  
  "serial_no":""  
}

BVN response structure

{  
  "bvn": ""  
}

Address response structure

{  
  "state_of_origin": "",  
  "lga_of_origin": "",  
  "state_of_residence": "",  
  "lga_of_residence": "",  
  "state_of_capture": "",  
  "residential_address": ""  
}

Contact info response structure

{  
  "Phone_number": " "  
}

Email address response structure

{  
  "email_address": ""  
}