Índia — Informações de votação e local EPIC (Voter ID)

Este endpoint retorna onde o eleitor está designado para votar: assembleia, distrito, seção (part), nome do prédio e campos de localização relacionados — com base em um EPIC válido de 10 caracteres (Elector's Photo Identity Card). Complementa a API de consulta de nome quando você precisa do contexto do local de votação para logística, suporte ou conformidade.

O que esta API valida?

A API retorna dados eleitorais de localização e designação para um EPIC, por exemplo:

Circunscrição e seção: identificadores de assembleia (AC), número e nome da seção, número de série quando aplicável.
Geografia: distrito, estado e associação parlamentar quando expostos pela fonte.
Local de votação: nome do prédio, endereço e detalhes de sala ou booth retornados para o EPIC.
Correspondência do EPIC: a consulta deve usar um EPIC válido de 10 caracteres em documentNumber.

Referência da API

Endpoint

https://api.verifik.co/v2/in/epic/votacion

Envie uma requisição GET com o EPIC no parâmetro documentNumber. A resposta é voltada a dados de local de votação (não o perfil só de nome de GET /v2/in/epic).

Headers

Nome	Valor
Content-Type	`application/json`
Authorization	`Bearer <token>`

Parâmetros

Nome	Tipo	Obrigatório	Descrição	Exemplo
`documentNumber`	string	Sim	EPIC / Voter ID. Deve ter exatamente 10 caracteres (alfanumérico).	`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

{
  "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

documentNumber deve ter exatamente 10 caracteres; comprimento ou formato inválido pode retornar 409.
A presença de campos pode variar por estado e disponibilidade da ECI; null pode aparecer em strings opcionais.
Para nome do eleitor e do parente apenas, use GET /v2/in/epic.

Casos de uso comuns

Centrais de ajuda ao eleitor: direcionar cidadãos ao local, AC e prédio corretos para um EPIC.
Logística e operações de campo: pré-validar a designação antes do envio ou suporte presencial.
Fluxos regulatórios e de auditoria em que é preciso mostrar a geografia eleitoral mapeada a um EPIC no momento da consulta.

Fontes oficiais e confiabilidade

A Verifik normaliza dados eleitorais orientados à ECI para um contrato de API único. Os resultados dependem do registro oficial no momento da consulta; sempre trate 404 para EPICs inválidos ou não retornados pela fonte atual.

Principais benefícios

TLS ponta a ponta e um formato JSON consistente com signature da Verifik em sucesso.
Complementa a consulta de nome: combine com /v2/in/epic para checagens EPIC estilo KYC quando nome e local forem necessários.

Conformidade e segurança

Proteja tokens Authorization e nunca registre valores EPIC brutos em analytics públicos. Mantenha a retenção de dados eleitorais conforme sua política e a legislação local. A Verifik aplica segurança de transporte e monitoramento na borda da API.

Sobre a Verifik

A Verifik unifica o acesso a serviços globais de identidade, veículos e registros sob um único modelo de segurança, para que você possa adicionar checagens eleitorais da Índia aos seus endpoints Verifik existentes.

O que esta API valida?​

Referência da API​

Endpoint​

Headers​

Parâmetros​

Request​

Response​

Notas​

Casos de uso comuns​

Fontes oficiais e confiabilidade​

Principais benefícios​

Conformidade e segurança​

Sobre a Verifik​