API reference / KYC / Identity
Verify voter ID
EPIC number checked against the electoral record, with the voter's details.
POST
/v1/verify/voter-id- Authentication
- Bearer token
- Scope
kyc:verify
Request body
| Field | Type | Required | Description |
|---|---|---|---|
epic_number | string | Yes | EPIC number printed on the voter ID card, 6 to 20 letters, digits or slashes. |
Sample code
Set your key in the GRAPPI_API_KEY environment variable. Sample values are placeholders.
curl -sS -X POST 'https://grappi.ai/v1/verify/voter-id' \
-H "Authorization: Bearer $GRAPPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"epic_number": "ABC1234567"
}'Sample response
{
"request_id": "req_01HZY3K8M2",
"result": {
"epic_number": "ABC1234567",
"name": "ASHA RAO",
"age": "36",
"gender": "F",
"relation_type": "FTHR",
"relation_name": "RAMESH RAO",
"address": "12 Example Lane, Pune, Maharashtra, 411001",
"split_address": {
"district": [
"Pune"
],
"state": [
"Maharashtra"
],
"city": [
"Pune"
],
"pincode": "411001",
"country": [
"India"
],
"address_line": "12 Example Lane"
},
"state": "Maharashtra",
"assembly_constituency_no": "210",
"assembly_constituency": "Example Central",
"parliamentary_constituency_no": "34",
"parliamentary_constituency": "Example",
"part_no": "112",
"serial_no": "345",
"polling_station": "Example Primary School"
}
}Response fields
| Field | Type | Description |
|---|---|---|
epic_number | string | The EPIC number that was checked. |
name | string | Voter's name. |
name_in_regional_lang | string | Voter's name in the regional language. |
age | string | Age on the electoral roll. |
dob | string | Date of birth, when the roll carries it. |
gender | string | Gender on the electoral roll. |
relation_type | string | How the voter is related to the person named next (for example father or husband). |
relation_name | string | Name of that relative. |
relation_name_in_regional_lang | string | Name of that relative in the regional language. |
father_name | string | Father's name, when recorded. |
address | string | Address on the electoral roll. |
split_address | object | The voter's address broken into parts. |
split_address.district | array | District name, as a list. |
split_address.state | array | State name, as a list. |
split_address.city | array | City name, as a list. |
split_address.pincode | string | Six-digit pincode. |
split_address.country | array | Country name, as a list. |
split_address.address_line | string | Street-level part of the address. |
state | string | State of the constituency. |
assembly_constituency_no | string | Assembly constituency number. |
assembly_constituency | string | Assembly constituency name. |
parliamentary_constituency_no | string | Parliamentary constituency number. |
parliamentary_constituency | string | Parliamentary constituency name. |
part_no | string | Part number of the electoral roll. |
part_name | string | Part name of the electoral roll. |
serial_no | string | Serial number within the part. |
polling_station | string | Polling station. |
photo | string | Link to the voter's photo, when available. |
Errors
Every failure has the same shape. A call that fails on our side or at the data source is refunded to your wallet; a "no record found" answer is charged. See the error reference.