Main API Docs
  • Welcome!
  • General
    • Introduction
    • Authentication
    • Personal Access Tokens
    • Test IDs
    • Check Wallet Balance
  • Appruve Identity
    • Introduction
    • Ghana 🇬🇭
      • Verify Ghana TIN
      • Verify Ghana Driver License
      • Verify Ghana SSNIT ID
      • Verify Ghana Passport
      • Verify Ghana Voter ID
      • Verify Ghana Digital Address
    • Nigeria 🇳🇬
      • Verify Nigeria TIN
      • Verify Nigeria Driver License
      • Verify Nigeria NIN
      • Verify Nigeria vNIN
      • Verify Nigeria Voter ID
      • Verify Nigeria BVN
    • Kenya 🇰🇪
      • Verify Kenya KRA PIN
      • Verify Kenya National ID
    • Uganda 🇺🇬
      • Verify Uganda Voter ID
      • Verify Uganda Telco Subscriber
      • BulK Uganda Telco Subscriber Verification
  • Appruve Business
    • Introduction
    • Business Lookups
      • Nigeria 🇳🇬
        • Lookup with CAC number
        • Lookup using Tax ID (TIN)
      • Uganda Business Lookup 🇺🇬
      • Ghana Business Lookup 🇬🇭
    • Business Beneficial Ownership
      • Nigeria 🇳🇬
  • Appruve Agency
    • OCR For Sequential Verification
      • Senegal 🇸🇳
      • Nigeria 🇳🇬
      • Ghana 🇬🇭
      • Kenya 🇰🇪
      • Côte d'Ivoire 🇨🇮
      • Cameroon 🇨🇲
    • Standalone OCR
      • Nigeria 🇳🇬
      • Ghana 🇬🇭
      • Kenya 🇰🇪
      • Côte d'Ivoire 🇨🇮
      • Cameroon 🇨🇲
      • Senegal 🇸🇳
    • Perform Face Matching
    • Upload Selfie Photo
    • Get Liveness Detection Challenge
    • Verify Liveness Detection Challenge
    • Confirm Extracted ID Number
    • Verify Business Document By OCR
    • Verify Nigeria vNIN with selfie
  • Guides
    • Webhooks
    • ID Document to Selfie Matching
  • Mobile Sdks
    • Android SDK
    • iOS SDK
  • Resources
    • Country Codes
    • ID Types
    • Face Liveness Check
Powered by GitBook
On this page
  1. Appruve Identity
  2. Nigeria 🇳🇬

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 support@appruve.co 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

{
  "id": "4812640614",
  "first_name": "John",
  "last_name": "Doe",
  "middle_name": "Donald",
  "date_of_birth": "1996-02-21",
  "phone_number": "+234000000000",
  "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"
}
{
    "message": "Invalid ID Details",
    "code": 5
}

PreviousVerify Nigeria NINNextVerify Nigeria Voter ID

Last updated 2 years ago