Virtual NIN Lookup

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

How does this work

  • The NIN holder can generate their virtual NIN via the NIMC Mobile App or the NIMC USSD code - _346_3_NIN_EnterpriseCode#.
  • Dojah’s Enterprise code - 1138183
  • The generated VNIN is valid for only 72 hours
  • The vNIN is designed to replace the 11-digit NIN for everyday usage. It is a unique 16-character alphanumeric token comprising 12 digits, sandwiched between 4 alphabets, two on each end, with no correlation to the issuer’s Raw NIN. An example of a vNIN is: AB012345678910YZ.
  • According to NIMC, The VNIN is not to be stored in any database but only used for verifying the NIN holder.




AppIdstringyou would need to create an app to get your app ID
Authorizationstringpublic secret key e.g prod_sk_1T1eSavlZxy02OT3OWlvbxK4G

Query Parameters

Parameter Type Description
vnin * string A uniquely generated virtual nin required

Response Sample

    "entity": {
        "vnin": "AB012345678910YZ",
        "firstname": "John",
        "middlename": "Doe",
        "surname": "Alamutu",
        "user_id": "WXABCD-1234",
        "gender": "M",
        "mobile": "08012345678",
        "dateOfBirth": "YYYY-MM-DD",
        "photo": "/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgc..."
    "error": "vnin not found"

Test Credentials for Sandbox

Sample = AB012345678910YZ