Guides

Voters Identification Number

This endpoint allows you to verify voter's card number

Suggest Edits

This endpoint is to provide a means for verifying the authenticity of a voter's card number, which is a unique identifier assigned to each registered voter. The process of verifying a voter's card number typically involves comparing it against a database of registered voters maintained by the election commission.

This database contains information such as the voter's name, address, and other identifying details, which are used to confirm that the card number is indeed associated with a valid voter.

👍

TEST DATA

number: 987f545AJ67890

last_name: test

first_name: test

dob: 2000-01-18

lga: ikeja

state: lagos

📘

POST

{{URL}}/identitypass/verification/voters_card

Header

KeyDescription
app-idYour App ID
x-api-keyYour Secret Key

Body

KeyDescription
stateState
last_nameLast name
numberVoters card number
first_nameFirst name
dobDate of birth
lgaLocal Government Area

Responses

{
    "status": true,
    "detail": "VIN Verification Successful",
    "response_code": "00",
    "vc_data": {
        "vin": "90F5AE4ADA294758893",
        "fullName": "Test Test",
        "first_name": "Test",
        "last_name": "Test",
        "pollingUnit": "Mall Centre",
        "date_of_birth": "2000-01-18",
        "gender": "",
        "state": "Lagos",
        "lga": "Ikeja",
        "registrationAreaWard": "Ikeja",
        "pollingUnitCode": "27-05-04-003",
        "identity_status": "Identity Matched",
        "occupation": "",
        "timeOfRegistration": ""
    },
    "verification": {
        "status": "VERIFIED",
        "reference": "739392fc-c3e8-4933-9073-8f7473886ae9"
    }
}

Response Description

ResponseDescription
statusIndicates that the request was successful.
detailThis field indicates the detail of the response.
response_codeRepresents the response code.
vc_dataAn array that contains the following data about a voter.
vinThe voter's identification number (VIN).
fullNameThe voter's full name.
first_nameThe voter's first name.
last_nameThe voter's last name.
pollingUnitThe name of the voter's polling unit.
date_of_birthThe voter's date of birth.
genderThe voter's gender.
stateThe voter's state of residence.
lgaThe voter's local government area.
registrationAreaWardThe voter's registration area ward.
pollingUnitCodeThe voter's polling unit code.
identity_statusThe voter's identity status, such as "Identity Matched" or "Identity Not Matched".
occupationThe voter's occupation.
timeOfRegistrationThe date and time at which the voter registered to vote.
verificationIt holds additional details about the verification process.
statusIndicates the status of the verification.
referenceIt is a string representing a unique reference or identifier associated with the verification process.

Updated 7 months ago