Voters Identification Number
This endpoint allows you to verify voter's card number
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
| Key | Description |
|---|---|
| app-id | Your App ID |
| x-api-key | Your Secret Key |
Body
| Key | Description |
|---|---|
| state | State |
| last_name | Last name |
| number | Voters card number |
| first_name | First name |
| dob | Date of birth |
| lga | Local 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
| Response | Description |
|---|---|
| status | Indicates that the request was successful. |
| detail | This field indicates the detail of the response. |
| response_code | Represents the response code. |
| vc_data | An array that contains the following data about a voter. |
| vin | The voter's identification number (VIN). |
| fullName | The voter's full name. |
| first_name | The voter's first name. |
| last_name | The voter's last name. |
| pollingUnit | The name of the voter's polling unit. |
| date_of_birth | The voter's date of birth. |
| gender | The voter's gender. |
| state | The voter's state of residence. |
| lga | The voter's local government area. |
| registrationAreaWard | The voter's registration area ward. |
| pollingUnitCode | The voter's polling unit code. |
| identity_status | The voter's identity status, such as "Identity Matched" or "Identity Not Matched". |
| occupation | The voter's occupation. |
| timeOfRegistration | The date and time at which the voter registered to vote. |
| verification | It holds additional details about the verification process. |
| status | Indicates the status of the verification. |
| reference | It is a string representing a unique reference or identifier associated with the verification process. |
Updated 8 months ago