India โ EPIC (Voter ID) polling and voting information
This endpoint returns where the voter is assigned to vote: assembly, district, part (polling-section) details, building name, and related location fieldsโbased on a valid 10-character EPIC (Elector's Photo Identity Card number). It complements the name-lookup API when you need polling-place context for logistics, support, or compliance checks.
What does this API validate?โ
The API returns electoral location and assignment data for a given EPIC, for example:
- Constituency and part: Assembly (AC) identifiers, part number and name, section serial where applicable.
- Geography: District, state, and parliamentary association where exposed by the source.
- Polling place: Building name, address, and any room or booth details returned for the EPIC.
- EPIC match: The query must use a full, valid 10-character EPIC in
documentNumber.
API Referenceโ
Endpointโ
https://api.verifik.co/v2/in/epic/votacion
Send a GET request with the EPIC in the documentNumber query parameter. The response is tailored to polling and voting-location data (not the name-only profile returned by GET /v2/in/epic).
Headersโ
| Name | Value |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
Parametersโ
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
documentNumber | string | Yes | EPIC / Voter ID. Must be exactly 10 characters (alphanumeric, as issued). | IHM2796746 |
Requestโ
- Node.js
- Python
import axios from "axios";
const { data } = await axios.get("https://api.verifik.co/v2/in/epic/votacion", {
params: { documentNumber: "IHM2796746" },
headers: { Accept: "application/json", Authorization: `Bearer ${process.env.VERIFIK_TOKEN}` },
});
console.log(data);
import os, requests
url = "https://api.verifik.co/v2/in/epic/votacion"
headers = {"Accept": "application/json", "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"}
params = {"documentNumber": "IHM2796746"}
r = requests.get(url, headers=headers, params=params)
print(r.json())
Responseโ
- 200
- 404
- 409
- 500
{
"data": {
"documentNumber": "IHM2796746",
"sectionNo": 1,
"partNumber": "142",
"partName": "Prafullakanan Deshapriya Bidyamandir (Balak)",
"partNameLocal": "เฆชเงเฆฐเฆซเงเฆฒเงเฆฒเฆเฆพเฆจเฆจ เฆฆเงเฆถเฆชเงเฆฐเฆฟเง เฆฌเฆฟเฆฆเงเฆฏเฆพเฆฎเฆจเงเฆฆเฆฟเฆฐ (เฆฌเฆพเฆฒเฆ)",
"partSerialNumber": 124,
"assemblyName": "Rajarhat Gopalpur",
"assemblyNameLocal": "เฆฐเฆพเฆเฆพเฆฐเฆนเฆพเฆ เฆเงเฆชเฆพเฆฒเฆชเงเฆฐ",
"acNumber": 117,
"districtName": "NORTH 24 PARGANAS",
"districtNameLocal": "เฆเฆคเงเฆคเฆฐ 24 เฆชเฆฐเฆเฆฃเฆพ",
"stateName": "West Bengal",
"stateNameLocal": "เคชเคถเฅเคเคฟเคฎ เคฌเคเคเคพเคฒ",
"parliamentName": "Dum dum",
"parliamentNameLocal": null,
"parliamentNo": "16",
"buildingName": "Prafullakanan Deshapriya Bidyamandir (Balak)",
"buildingNameLocal": "เฆชเงเฆฐเฆซเงเฆฒเงเฆฒเฆเฆพเฆจเฆจ เฆฆเงเฆถเฆชเงเฆฐเฆฟเง เฆฌเฆฟเฆฆเงเฆฏเฆพเฆฎเฆจเงเฆฆเฆฟเฆฐ (เฆฌเฆพเฆฒเฆ)",
"buildingAddress": "Krishnapur",
"buildingAddressLocal": "เฆเงเฆทเงเฆฃเฆชเงเฆฐ",
"roomDetails": "- ROOM-2"
},
"signature": {
"dateTime": "March 25, 2026 10:54 AM",
"message": "Certified by Verifik.co"
},
"id": "0JXEN"
}
{
"code": "NotFound",
"message": "Record not found."
}
{
"code": "MissingParameter",
"message": "missing documentNumber\n"
}
{
"code": "InternalServerError",
"message": "Server error."
}
Notesโ
documentNumbermust be exactly 10 characters; invalid length or format may return409.- Field presence can vary by state and ECI data availability;
nullmay appear for optional string fields. - For voter name and relative name only, use GET /v2/in/epic.
Common use casesโ
- Voter help desks: Direct citizens to the correct polling station, AC, and building for an EPIC.
- Logistics and field operations: Pre-validate assignment before dispatch or in-person support.
- Regulatory and audit workflows where you must show which electoral geography an EPIC maps to at query time.
Official sources and reliabilityโ
Verifik normalizes ECI-oriented electoral data so you can rely on a single API contract. Results depend on the official registry at lookup time; always handle 404 for EPICs that are invalid or not returned by the current source.
Key benefitsโ
- End-to-end TLS and a consistent JSON shape with a Verifik
signatureon success. - Complements name lookup: Pair with
/v2/in/epicfor full KYC-style EPIC checks when both name and location are required.
Compliance and securityโ
Protect Authorization tokens and never log raw EPIC values in public analytics. Keep retention of electoral data within your policy and local law. Verifik enforces transport security and platform-level monitoring on the API edge.
About Verifikโ
Verifik unifies access to global identity, vehicle, and registry services behind one security model, so you can add India electoral checks alongside your existing Verifik endpoints.