vNIN

This endpoint verifies a customer's identity using their uniquely generated Virtual NIN (vNIN). The vNIN is generated from NIMC's mobile app

There are 2 types of NIN APIs

1. vNIN Lookup

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:

  1. NIMC official mobile app
  2. USSD - *346*3*customer NIN*696739#

AiPrise Short Code: 696739

Request:

{
    "template_id" : "NIN_VERIFICATION",
    "user_data": {
        "identity": {
            "identity_country_code": "NG",
            "identity_number_type": "NIN",
            "identity_number": "{{Valid_16_Digit_vNIN_Number}}"
        },
    }
}

Response:

{
    "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": ""
}

2. NIN with Face Match

Our NIN with face endpoint uses powerful algorithms to authenticate their identity by matching their NIN against uploaded images.

Request:

{
    "template_id" : "NIN_VERIFICATION",
    "user_data": {
        "identity": {
            "identity_country_code": "NG",
            "identity_number_type": "NIN",
            "identity_number": "{{Valid_11_Digit_NIN_Number}}"
        },
        "selfie": "{{Valid_Base64_String}}"
    }
}

Response:

{
    "aiprise_summary": {
        "verification_result": "APPROVED"
    },
    "client_reference_id": null,
    "created_at": 123456789,
  
    // Face Match Info
    "face_match_info": {
      "face_match_score": 98.44,
      "result": "APPROVED"
    },
 
    // 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": ""
}