Verify Nigeria vNIN

Verify Nigeria Virtual NIN

The Virtual NIN (vNIN) is a tokenized version of a user's actual NIN which is given to third parties like Appruve for verification purposes. This tokenized version means the user's actual NIN is kept private. The vNIN is a 16-digit set of alphanumeric characters which expires 72 hours after being generated.

How to generate vNIN via USSD

To generate a Virtual NIN via USSD, dial *346*3*Your NIN*Agent Code#

An SMS message will be sent back to you containing the Virtual NIN generated for you. Contact [e-mail] for the Agent Code.

How to generate vNIN via the NIMC app

1. Download the NIMC App

2. Click on "Get Virtual NIN"

3. Select "Input Enterprise short-code" and type the Agent Code

4. Click "Submit" and your virtual NIN will be generated.

Verify vNIN

POST https://api.appruve.co/v1/verifications/ng/virtual_nin

This endpoint allows you to verify a Nigeria Virtual NIN (vNIN)

Headers

Name	Type	Description
Authorization*	string	Bearer <token>

Request Body

Name	Type	Description
vnin*	string	The vNIN
first_name	string	The first name of the vNIN holder
last_name	string	The last name of the vNIN holder
middle_name	string	The middle name of the vNIN holder
date_of_birth	string	The date of birth of the vNIN holder
phone_number	string	The phone number of the vNIN holder

200 Verification is a success

{
  "id": "4812640614",
  "first_name": "John",
  "last_name": "Doe",
  "middle_name": "Donald",
  "date_of_birth": "1996-02-21",
  "phone_number": "[phone]",
  "gender": "M",
  "is_first_name_match": true,
  "is_last_name_match": true,
  "is_middle_name_match": true,
  "is_date_of_birth_match": true,
  "is_phone_number_match": true,
  "is_gender_match": true,
  "image": "BASE_64 encoded image",
  "verification_ref" "eedbc8bd-dfd8-4d24-846d-597e95872e08"
}

404 Could not find a matching record

{
    "message": "Invalid ID Details",
    "code": 5
}