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

NameTypeDescription

x-api-key*

string

<your secret key>

app-id*

String

<your app id>

Request Body

NameTypeDescription

number*

string

Virtual NIN

number_nin*

String

Raw NIN

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

Last updated