Electoral

Resultados electorales

Drill-down dept→mun→puesto→mesa. Etiqueta preconteo|escrutinio siempre presente.

get/v1/electoral/resultados

Request

  • Base URL: https://api.alfil.co
  • URL: https://api.alfil.co/v1/electoral/resultados
  • Auth: OAuth 2 (authorization code, authorization URL https://api.alfil.co/oauth/authorize, token URL https://api.alfil.co/oauth/token, scopes: buscar:read)

Query parameters

cursorinteger

Cursor de paginación (posición del ranking desde la que continuar)

limitinteger

Máximo de resultados (1-100, default 25)

eleccionstring required

Código público {tipo}-{año}[-{ámbito}] (p. ej. presidencia-2026, presidencia-2026-2v, camara-2026-antioquia, alcalde-2023-medellin) o id interno numérico

departamentostring

Nombre de departamento (accent-insensitive); ignorado si el código ya trae ámbito departamental

municipiostring

Nombre de municipio + departamento resuelto; ambiguo → error accionable

zonastring

Nombre de zona/localidad (hoy solo localidades de Bogotá)

puestostring

Nombre/código de puesto de votación, acotado al municipio resuelto; ambiguo → no se resuelve (queda en el nivel anterior)

orden'votos_desc'

Orden de los resultados (hoy solo votos_desc, el único que soporta el RPC)

partidostring

Nombre del partido para filtrar (case-insensitive; no es un slug real pese al nombre del parámetro RPC)

Response

Resultados por ámbito

Example response

{
  "resultados": [
    {
      "votos": "48213",
      "ranking": "1"
    }
  ],
  "fuente": {
    "nombre": "SECOP II — datos.gov.co",
    "corte": "2026-07-09",
    "licencia": "CC BY-SA 4.0"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.