India — EPIC: información de votación y mesa
Este endpoint devuelve dónde vota el elector: asignación a asamblea (AC), distrito, parte (sección de votación), edificio y datos de ubicación asociados a un EPIC válido de 10 caracteres. Complementa la API de solo nombres cuando necesitas logística, soporte o comprobación de padrón por lugar de votación.
¿Qué valida esta API?
- Constituency y sección: Identificadores de asamblea, número y nombre de parte, número de sección/serie según el origen.
- Geografía: Distrito, estado y vinculación parlamentaria si el origen la expone.
- Lugar de votación: Nombre y dirección del edificio, detalle de sala o habitación cuando aplique.
- EPIC: El cuerpo de la consulta exige un EPIC de 10 caracteres en
documentNumber.
Referencia de la API
Endpoint
https://api.verifik.co/v2/in/epic/votacion
GET con documentNumber (EPIC de 10 caracteres). La respuesta se orienta a datos de mesa y ubicación (no al perfil de nombres de GET /v2/in/epic).
Headers
| Nombre | Valor |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
Parámetros
| Nombre | Tipo | Requerido | Descripción | Ejemplo |
|---|---|---|---|---|
documentNumber | string | Sí | EPIC / Voter ID. Exactamente 10 caracteres (alfanumérico). | IHM2796746 |
Solicitud
- 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())
Respuesta
- 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."
}
Notas
documentNumberdebe ser un EPIC de 10 caracteres; fallos de validación pueden devolver409.- Algunos campos pueden ser
nullsegún el estado o la fuente. Trata el404para EPIC no encontrados o no servidos. - Solo nombres del votante: usa GET /v2/in/epic.
Casos de uso frecuentes
- Mesa de ayuda electoral: Indicar AC, sección, edificio y dirección a partir del EPIC.
- Operaciones de campo y logística el día de la votación o en campañas de información.
Fuentes oficiales y fiabilidad
Verifik normaliza datos electorales alineados con la ECI. Los resultados dependen del registro en el momento de la consulta; maneja siempre el 404 con claridad hacia el usuario final.
Ventajas clave
- Misma seguridad y modelo que el resto de API Verifik: JSON homogéneo y bloque
signatureen aciertos. - Complementa la consulta de nombres cuando el caso de negocio exige ubicación y mesa, no solo identidad.
Cumplimiento y seguridad
Protege el token de Authorization y evita registrar EPICs en analítica pública. Cumple retención y ley local de datos. El borde de la API de Verifik usa cifrado en tránsito (TLS).
Sobre Verifik
Verifik unifica acceso a servicios de identidad y registro a nivel global, con un marco de seguridad coherente para tu stack.