Electoral

Desglose geográfico de una elección

Votos totales (o de un candidato) por cada hijo geográfico del ámbito consultado (dept→mun→zona/puesto→mesa).

get/v1/electoral/desglose

Request

Base URL: https://api.alfil.co
URL: https://api.alfil.co/v1/electoral/desglose
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

eleccionstring required

Código público {tipo}-{año}[-{ámbito}] (p. ej. presidencia-2026, camara-2026-antioquia) 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á); alias de "localidad"

localidadstring

Alias de "zona" — localidades de Bogotá

candidatostring

Cédula del candidato para desglosar SUS votos por hijo geográfico (en vez del total). Cruce legítimo de control social (ADR-020).

orden'votos_desc' | 'votos_asc'

votos_desc (default) o votos_asc. Combinado con "candidato", votos_asc responde "¿dónde debería fortalecerme?" (los hijos donde el candidato sacó menos votos primero).

Response

Desglose por hijo geográfico

orden'votos_desc' | 'votos_asc' required

Example response

{
  "hijos": [
    {
      "votos": "48213"
    }
  ],
  "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.