Lookup Voters ID

Fetch identity details for a Nigerian voter using their Voter Identification Number. Returns name, photo, and other details from the electoral register.

Request

[GET]

{{baseUrl}}/api/v1/kyc/vin

Header

Header	Type	Description
AppId	string	Create an app to get your app ID on dashboard here
Authorization	string	Private/secret key. Use <key> not Bearer <key>

Query parameters

vin

string

Voter’s identification number

optional

Sample response

[200]

{
  "entity": {
    "full_name": "JOHN DOE",
    "voter_identification_number": "91F1234567890123",
    "gender": "Male",
    "occupation": "STUDENT",
    "time_of_registration": "2011-02-18 13:59:46",
    "state": "ONDO",
    "local_government": "IDANRE",
    "registration_area_ward": "",
    "polling_unit": "OJAJIGBOKIN, O/S IN FRONT OF ABANA I & II",
    "polling_unit_code": "12/03/04/005",
    "address": "NO 16 OWODE QTS KABBA",
    "phone": "0812345678",
    "date_of_birth": "1960-10-16"
  }
}

Response Fields

Field	Type	Description
entity	object	Contains the voter identity verification response data
entity.full_name	string	Full name of the voter as registered
entity.voter_identification_number	string	Voter Identification Number (VIN)
entity.gender	string	Gender of the voter
entity.occupation	string	Registered occupation of the voter
entity.time_of_registration	string	Date and time of voter registration
entity.state	string	State where the voter is registered
entity.local_government	string	Local government area of registration
entity.registration_area_ward	string	Registration area or ward
entity.polling_unit	string	Name and location of the assigned polling unit
entity.polling_unit_code	string	Unique code identifying the polling unit
entity.address	string	Residential address of the voter
entity.phone	string	Phone number of the voter
entity.date_of_birth	string	Date of birth of the voter (YYYY-MM-DD)

Test Credentials for Sandbox

Kindly use this Test VIN in sandbox Environment

VIN = 91F6B1F5BE29535558655586