VIN Lookup

post https://sandbox-api.oneliquidity.technology/compliance/v1/gov/ng/vin

Use this endpoint to verify a user's identity information and their Voting Identity Number (VIN) through the Independent National Electoral Commission (INEC).

Sample request body

{
  "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",
}

Response

The result of this endpoint is sent to the integrator's webhook URL. An example response is given below:

{
  "event": "COMPLIANCE_VIN_EVENT",
  "message": "Ok",
  "data": {
    "createdAt": "2022-08-13T10:09:22.180Z",
    "fullName": "ADEKUNLE CIROMA I.",
    "lastName": "ADEKUNLE",
    "localGovernment": "ONDO SOUTH",
    "pollingUnit": "TOWN HALL I",
    "pollingUnitCode": "19-10-17-031",
    "registrationAreaWard": "EWEDU",
    "state": "ONDO",
    "status": "completed",
    "vin": "80F5C18A1C295707777",
    "id": "43f91e9a-43bd-4572-9bfe-cc0118ff9c30"
  },
  "checksum": "0f5d491ca50a084b10937b89cdefd531f0a976fc52a4cc57b9daed141efe1f86"
}