Nigeria
With just the number of a government issued ID, we can fetch all the information from the official government databases.
BVN
Regex: /^[0-9]{11}$/
BVN API gives all the details about a user including user's name, address, phone number and their photo.
{
"template_id" : "{{YOUR_TEMPLATE_ID}}",
"user_data": {
"identity": {
"identity_country_code": "NG",
"identity_number_type": "BVN",
"identity_number": "{{Valid_BVN_Number}}"
}
}
}
{
"aiprise_summary": {
"verification_result": "APPROVED"
},
"client_reference_id": null,
"created_at": 123456789,
// Identity Info
"id_info": {
// Normalized fields.
"address": {
"full_address": "",
"parsed_address": null
},
"birth_date": "YYYY-MM-DD",
"first_name": "",
"full_name": "",
"gender": "",
"id_issue_date": "YYYY-MM-DD",
"id_number": "",
"id_type": "BVN",
"issue_country": "Nigeria",
"issue_country_code": "NG",
"last_name": "",
"middle_name": "",
"nationality": "Nigeria",
// Government Lookup details.
"lookup_details": {
"lookup_list": [
{
"lookup_source": "Nigerian Inter-Bank Settlement Systems",
"lookup_type": "BVN",
"issuer_country_code": "NG",
"lookup_data": {
"birth_date": "YYYY-MM-DD",
"bvn": "",
"email": "",
"enrollment_bank": "",
"enrollment_branch": "",
"first_name": "",
"gender": "",
"last_name": "",
"level_of_account": "",
"lga_of_origin": "",
"lga_of_residence": "",
"marital_status": "",
"middle_name": "",
"name_on_card": "",
"nin": "",
"phone_number": "",
"phone_number2": "",
"registration_date": "YYYY-MM-DD",
"state_of_origin": "",
"state_of_residence": "",
"title": "",
"user_photo": "{{BASE64_STRING}}",
"watch_listed": null
}
}
]
},
"result": "APPROVED"
},
"status": "COMPLETED",
"template_id": "{{YOUR_TEMPLATE_ID}}",
"verification_session_id": ""
}
Virtual NIN
The Virtual NIN (vNIN) is designed to replace the raw 11-digit NIN for everyday usage. Where until now, the raw NIN had been shared and stored by various entities mostly without the knowledge (or consent) of the ID Holder or the Custodian of Identity in Nigeria, the NIMC has now mandated that companies generate vNIN number from NIN using the NIMC mobile app and use the 16 digit vNIN for KYC.
Virtual NIN consists of 16 alpha-numeric characters that can be generated using:
- NIMC official mobile app
- USSD - *346*3*customer NIN*696739#
AiPrise Short Code: 696739
Regex: /^[a-zA-Z0-9]{16}$/
{
"template_id" : "NIN_VERIFICATION",
"user_data": {
"identity": {
"identity_country_code": "NG",
"identity_number_type": "NIN",
"identity_number": "{{Valid_16_Digit_vNIN_Number}}"
},
}
}
{
"aiprise_summary": {
"verification_result": "APPROVED"
},
"client_reference_id": null,
"created_at": 123456789,
// Identity Info
"id_info": {
// Normalized fields.
"address": {
"full_address": "",
"parsed_address": {
"address_city": "",
"address_country": null,
"address_state": "",
"address_street_1": null,
"address_street_2": null,
"address_zip_code": null
}
},
"birth_date": "YYYY-MM-DD",
"first_name": "",
"full_name": "",
"gender": "",
"id_type": "VNIN",
"issue_country": "Nigeria",
"issue_country_code": "NG",
"last_name": "",
"middle_name": "",
// Government Lookup details.
"lookup_details": {
"lookup_list": [
{
"lookup_source": "Central Bank of Nigeria",
"lookup_type": "VNIN",
"issuer_country_code": "NG",
"lookup_data": {
"birth_country": "",
"birth_date": "",
"birth_lga": "",
"birth_state": "",
"central_id": "",
"education_level": "",
"email": "",
"employment_status": "",
"first_name": "",
"gender": "",
"height": null,
"id_number": "",
"last_name": "",
"marital_status": "",
"middle_name": "",
"nin": "",
"nok_address1": "",
"nok_address2": "",
"nok_lga": "",
"nok_state": "",
"nok_town": "",
"postal_code": "",
"profession": "",
"religion": "",
"residence_address": "",
"residence_lga": "",
"residence_state": "",
"residence_status": "",
"residence_town": "",
"self_origin_lga": "",
"self_origin_place": "",
"self_origin_state": "",
"signature": "",
"spoken_language": "",
"telephone_number": "",
"title": "Mr",
"tracking_id": "",
"user_id": "{{BASE64_STRING}}",
"user_photo": ""
}
}
]
},
"result": "APPROVED"
},
"status": "COMPLETED",
"template_id": "{{YOUR_TEMPLATE_ID}}",
"verification_session_id": ""
}
NIN
The NIN endpoint requires the 11 digit NIN Number and a selfie of the user. This API confirms the NIN Number and also fetches the user photo and NIN slip document.
Regex: /^[a-zA-Z0-9]{11}$/
{
"template_id" : "{{YOUR_TEMPLATE_ID}}",
"user_data": {
"identity": {
"identity_country_code": "NG",
"identity_number_type": "NIN",
"identity_number": "{{Valid_11_Digit_NIN_Number}}"
},
"selfie": "{Base_64_String}"
}
}
Drivers License
Validate the driver license number of a user against the government database.
Regex: /^[a-zA-Z]{3}([ -]{1})?[A-Z0-9]{6,12}$/
{
"template_id" : "{{YOUR_TEMPLATE_ID}}",
"user_data": {
"identity": {
"identity_country_code": "NG",
"identity_number_type": "DRIVER_LICENSE",
"identity_number": "{{Valid_Driver_License_Number}}"
},
}
}
{
"aiprise_summary": {
"verification_result": "APPROVED"
},
"client_reference_id": null,
"created_at": 123456789,
"id_info": {
// Id Info result
"result": "APPROVED",
// Normalized Fields
"birth_date": "YYYY-MM-DD",
"first_name": "",
"middle_name": "",
"gender": "",
"id_expiry_date": "YYYY-MM-DD",
"id_issue_date": "YYYY-MM-DD",
"issue_country": "Nigeria",
"issue_country_code": "NG",
"id_number": "",
"id_type": "DRIVER_LICENSE_NUMBER",
"last_name": "",
// Government lookup details
"lookup_details": {
"lookup_list": [
{
"lookup_source": "Federal Road Safety Commission (FRSC)",
"lookup_type": "DRIVER_LICENSE",
"issuer_country_code": "NG",
"lookup_data": {
"birth_date": "",
"expiry_date": "",
"first_name": "",
"gender": "",
"issue_date": "",
"issue_state": "",
"last_name": "",
"license_number": "",
"middle_name": "",
"user_photo": "<Base64String>"
},
}
]
}
},
"status": "COMPLETED",
"template_id": "{{YOUR_TEMPLATE_ID}}",
"verification_session_id": ""
}
Passport
Validate the passport number of a user against the government database. This API requires just Passport number and user's last name as input.
Regex: /^[A-Z][0-9]{7,9}$/
{
"template_id" : "NG_PASSPORT_NUMBER_VERIFICATION",
"user_data": {
"identity": {
"identity_country_code": "NG",
"identity_number_type": "PASSPORT",
"identity_number": "{{Valid_Passport_Number}}",
},
"last_name": "{{User_Last_Name}}"
}
}
{
"aiprise_summary": {
"verification_result": "APPROVED"
},
"client_reference_id": null,
"created_at": 123456789,
"id_info": {
// Normalized fields.
"birth_date": "YYYY-MM-DD",
"first_name": "",
"full_name": "",
"gender": "",
"id_expiry_date": "YYYY-MM-DD",
"id_issue_date": "YYYY-MM-DD",
"id_number": "",
"id_type": "PASSPORT_NUMBER",
"issue_country": "Nigeria",
"issue_country_code": "NG",
"last_name": "",
"middle_name": "",
"result": "APPROVED",
// Government Lookup details.
"lookup_details": {
"lookup_list": [
{
"issuer_country_code": "NG",
"lookup_data": {
"birth_date": "",
"expiry_date": "",
"first_name": "",
"gender": "",
"issue_date": "",
"issue_place": "",
"last_name": "",
"middle_name": "",
"mobile": "",
"passport_number": "",
"user_photo": "{{BASE64_STRING}}",
"user_signature": "{{BASE64_STRING}}"
},
"lookup_source": "Nigeria Immigration Service",
"lookup_type": "PASSPORT"
}
]
},
},
"status": "COMPLETED",
"template_id": "{{YOUR_TEMPLATE_ID}}",
"verification_session_id": ""
}
Voter ID
Regex: /^[a-zA-Z0-9]{9,20}$/
Voter ID Number does not return the selfie of the user from the government database so cannot be used for face match.
{
"template_id" : "NG_VOTERID_NUMBER_VERIFICATION",
"user_data": {
"identity": {
"identity_country_code": "NG",
"identity_number_type": "VOTER_ID",
"identity_number": "{{Valid_Voter_Id_Number}}",
}
}
}
{
"aiprise_summary": {
"verification_result": "APPROVED"
},
"client_reference_id": null,
"created_at": 123456789,
"id_info": {
// Normalized fields.
"full_name": "",
"gender": "",
"id_issue_date": "YYYY-MM-DD",
"id_number": "",
"id_type": "VOTER_ID_NUMBER",
"issue_country": "Nigeria",
"issue_country_code": "NG",
// Government Lookup details.
"lookup_details": {
"lookup_list": [
{
"issuer_country_code": "NG",
"lookup_source": "Independent National Electoral Commission",
"lookup_type": "VOTER_ID",
"lookup_data": {
"birth_date": "",
"full_name": "",
"gender": "",
"issue_date": "",
"issue_state": "",
"vin": "",
"occupation": "",
"local_government": "",
"registration_area_ward": "",
"polling_unit": "",
"polling_unit_code": "",
"phone": "",
}
}
]
},
"result": "APPROVED"
},
"status": "COMPLETED",
"template_id": "{{YOUR_TEMPLATE_ID}}",
"verification_session_id": ""
}
Updated 2 months ago