Lookup Virtual NIN

Test Data: AA1234567890123B (VNIN) OR Test Data: 12345678909 (RAW 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. 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# Identitypass Short Code: 696739

lookup Virtual NIN

POST {{BASE_URL}}/api/v2/biometrics/merchant/data/verification/nin_wo_face

This endpoint allows you to look up a virtual national identification number

Headers

Name	Type	Description
x-api-key*	string	<your secret key>
app-id*	String	<your app id>

Request Body

Name	Type	Description
number*	string	Virtual NIN
number_nin*	String	Raw NIN

200 Data successfully retrieved.

{
    "status": true,
    "detail": "Verification Successful",
    "nin_data": {
        "birthcountry": "",
        "birthdate": "21 JAN 1990",
        "birthlga": "",
        "birthstate": "",
        "centralID": "",
        "educationallevel": "",
        "email": "",
        "emplymentstatus": "",
        "firstname": "",
        "gender": "f",
        "heigth": "",
        "maritalstatus": "single",
        "nin": "",
        "nok_address1": "",
        "nok_address2": "",
        "nok_firstname": "",
        "nok_lga": "",
        "nok_middlename": "",
        "nok_postalcode": "",
        "nok_state": "",
        "nok_surname": "",
        "nok_town": "",
        "nspokenlang": "YORUBA",
        "ospokenlang": "",
        "pfirstname": "",
        "photo": "",
        "pmiddlename": "",
        "profession": "",
        "psurname": "",
        "religion": "christianity",
        "residence_AdressLine1": "",
        "residence_Town": "",
        "residence_lga": "",
        "residence_state": "",
        "residencestatus": "",
        "self_origin_lga": "",
        "self_origin_place": "",
        "self_origin_state": "",
        "signature": "",
        "surname": "",
        "telephoneno": "",
        "title": "",
        "vnin": "",
        "userid": ""
    },
    "verification": {
        "status": "",
        "reference": ""
    }
}