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

FieldTypeRequiredDescription
epic_numberstringYesEPIC 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

FieldTypeDescription
epic_numberstringThe EPIC number that was checked.
namestringVoter's name.
name_in_regional_langstringVoter's name in the regional language.
agestringAge on the electoral roll.
dobstringDate of birth, when the roll carries it.
genderstringGender on the electoral roll.
relation_typestringHow the voter is related to the person named next (for example father or husband).
relation_namestringName of that relative.
relation_name_in_regional_langstringName of that relative in the regional language.
father_namestringFather's name, when recorded.
addressstringAddress on the electoral roll.
split_addressobjectThe voter's address broken into parts.
split_address.districtarrayDistrict name, as a list.
split_address.statearrayState name, as a list.
split_address.cityarrayCity name, as a list.
split_address.pincodestringSix-digit pincode.
split_address.countryarrayCountry name, as a list.
split_address.address_linestringStreet-level part of the address.
statestringState of the constituency.
assembly_constituency_nostringAssembly constituency number.
assembly_constituencystringAssembly constituency name.
parliamentary_constituency_nostringParliamentary constituency number.
parliamentary_constituencystringParliamentary constituency name.
part_nostringPart number of the electoral roll.
part_namestringPart name of the electoral roll.
serial_nostringSerial number within the part.
polling_stationstringPolling station.
photostringLink 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.