Lookup VIN

This endpoint allows you to fetch a person's details using the Voter's Identification Number of the Individual.

πŸ“˜

NOTE

This endpoint can be used in two modes; the mode parameter can either be set to vin or dob

When the mode parameter is set to vin. the following parameters are compulsory:

  • state
  • last name
  • vin

When the mode parameter is set to dob. the following parameters are compulsory:

  • state
  • first name
  • last name
  • date of birth

Request

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

Header

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
mode * string can be vin or dob required
vin string Voter's identification number optional
state string a state in Nigeria optional
firstname string First name of VIN holder optional
lastname string Last name of VIN holder optional
dob string date of birth in yyyy-mm-dd format optional

Response Sample

"entity": {
    "full_name": "JOHN HARRY GOKE",
    "voter_identification_number:": "90F5B1C5BD295355586",
    "gender:": "Male",
    "occupation:": "STUDENT",
    "time_of_registration:": "2011-01-18 13:59:46",
    "state:": "ONDO",
    "local_government:": "IDANRE",
    "registration_area_ward:": "ISALU JIGBOKIN",
    "polling_unit:": "OJAJIGBOKIN, O/S IN FRONT OF ABANA I & II",
    "polling_unit_code": "28/08/08/005"
}
curl -L -X GET '{{baseUrl}}/api/v1/kyc/vin?mode=vin&firstname={{first_name}}&lastname={{last_name}}&vin={{vin_no}}&state={{state}}' \
-H 'Content-Type: application/json' \
-H 'Authorization: SECRET_KEY'

Did this page help you?