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.
Request
{{baseURL}}/api/v1/kyc/vnin
Headers
Parameter | Type | Description |
---|---|---|
AppId | string | you would need to create an app to get your app ID |
Authorization | string | public 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
Updated 3 months ago