Government Database Lookup

NIN Lookup

This endpoint looks up the user details on National Identity Management Commission (NIMC) database given the Virtual National Identity Number (vNIN).

API Request Body

{
  "vnin": "JZ426633988976CH",
  "firstName": "DOE",
  "lastName": "JOHN",
  "dateOfBirth": "1962-12-28",
  "verificationId": "c61060e9-635a-5392-b39d-b1c27479d67c"
}

NIN Lookup Fields

Field	Description	Type
verificationId	The verification id from the initialized verification	string
firstName	The bearer's first name	string
lastName	The bearer's last name	string
dateOfBirth	The bearer's date of birth	string
vNIN	one-time verification code from the official NIMC Application or code generated via USSD request 3463Your NIN715461#	string

API Response

{
  "message": "Ok"
}

API Reference ➡️

BVN Lookup

This endpoint looks up the user’s Bank Verification Number (BVN) on the banking industry database in Nigeria.

API Request Body

{
    "bvn":"24444896000",
    "firstName": "John",
    "lastName": "Ciroma",
    "verificationId": "c61060e9-635a-5392-b39d-b1c27479d67c"
}

BVN Lookup Fields


Field	Description	Type
verificationId	The verification id from the initialized verification	string
bvn	The BVN number to lookup the details.	string
firstName	The first name of the BVN owner	string
lastName	The last name of the BVN owner	string

API Response

{
  "message": "Ok"
}

API Reference ➡️

Drivers License Lookup

This endpoint looks up the details of the user linked to the supplied license number from Federal Road Safety Commission (FRSC) database.

API Request Body

{
  "verificationId":"c61060e9-635a-5392-b39d-b1c27479d67c",
  "licenseNumber":"IKJ29459AB13"
}

Drivers License Lookup Fields


Field	Description	Type
verificationId	The verification id from the initialized verification	string
licenseNumber	The driving license number to look up	string
firstName	The first name of the BVN owner	string

API Response

{
  "message": "Ok"
}

API Reference ➡️

Voter Identification Number (VIN) Lookup

This endpoint looks up the supplied user’s Voter Identification Number (VIN) or name and date of birth from the Independent National Electoral Commission (INEC) database in Nigeria.

API Request Body
The request body comes in two ways depending on the mode selected. They are shown below.

{
  "verificationId":"c61060e9-635a-5392-b39d-b1c27479d67c",
  "mode":"dob",
  "lastName":"ADEKUNLE",
  "state":"Anambra",
  "dob":"1981-04-25",
  "firstName":"CIROMA"     
}

{
  "verificationId": "b7535048-76f8-4f60-bdd3-9d659298f9e7",
  "mode": "vin",
  "lastName": "Doe",
  "state": "ONDO",
  "firstName": "John",
  "vin": "80F5C18A1C295707777",
}

VIN Lookup Fields


Field	Description	Type
VerificationId	The verification id from the initialized verification	string
mode	The mode which could be dob or vin	string
lastName	The last name of the user	string
firstName	The first name of the user	string
state	The state the voter registered for voting	string
vin	The Voter Identification Number to lookup	string
dob	The date of birth of the user.	string

API Response

{
  "message": "Ok"
}

API Reference ➡️