Ghana Voters Card (GVC) Verification
GVC Lookup API
To perform verification on a Ghana Voters Card (GVC), make a POST request to the following endpoint;
https://api.korapay.com/merchant/api/v1/identities/gh/voters-card
Data Validation for GVC
Data validation for Ghana Voters Card (GVC) enables you to verify a GVC and validate the information in the government database against the data parameters you provided when the verification request was made. You can validate the first_name
, last_name
, and date_of_birth
by passing this information in the request body to get a true
or false
response on whether they match the information in the database. Use the same endpoint above to make this request.
Facial Matching for GVC
Facial matching for GVC enables you to compare the card holder’s image in the government database against the image provided when the verification request was made. A confidence score of how well the images match will be returned. Use the same endpoint above to make this request.
The request body should have the following parameters:
{
"id": "11111111111",
"type": "old_voters_card",
"verification_consent": true
}
{
"id": "11111111111",
"type": "old_voters_card",
"verification_consent": true,
"validation": {
"first_name": "John",
"last_name": "Doe",
"date_of_birth": "1988-04-04"
}
}
{
"id": "9001330422",
"type": "old_voters_card",
"verification_consent": true,
"validation": {
"first_name": "Viola",
"last_name": "Doe",
"date_of_birth": "1988-10-16",
"selfie": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQA"
}
}
The fields in this request include:
Field | Data Type | Description |
---|---|---|
id | String | Required - the ID number |
type | String | Required - the type of voters card. This can be either old_voters_card or new_voters_card . |
verification_consent | Boolean | Required - this indicates that subject has given consent to perform this verification. This must be true for the check to be performed. |
validation.first_name | String | Optional (required for data matching) - the first name of the ID holder to be compared with ID information in the government database. |
validation.last_name | String | Optional (required for data matching) - the last name of the ID holder to be compared with ID information in the government database. |
validation.date_of_birth | String | Optional (required for data matching) - the date of birth of the ID holder to be compared with ID information in the government database. |
validation.selfie | String | Optional (required for facial matching) - the selfie/photo of the ID holder to be compared with ID information in the government database. |
The response to this request would look like this:
{
"status": true,
"message": "GH voters card verified successfully",
"data": {
"reference": "VR-q8sBLWWkVZeiJYRcR",
"id": "9001330422",
"id_type": "gh_voters_card",
"first_name": "Kamaldeen",
"last_name": "Semenyo",
"middle_name": null,
"full_name": "Kamaldeen Semenyo",
"date_of_birth": null,
"polling_station": "G161613",
"nationality": "GHANAIAN",
"age": 27,
"voter_type": "old_voters_card",
"gender": "male",
"image": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAAAQA",
"validation": {
"first_name": {
"value": "Viola",
"match": false
},
"last_name": {
"value": "doe",
"match": false
},
"date_of_birth": {
"value": "1988-10-16",
"match": false
},
"selfie": {
"value": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQAA",
"match": true,
"confidence_rating": 97
}
},
"requested_by": "API User"
}
}
Updated 2 months ago