Electoral

Puestos de votación geolocalizados

Puestos de un municipio con coordenadas, para razonamiento espacial y mapas.

get/v1/electoral/puestos

Request

  • Base URL: https://api.alfil.co
  • URL: https://api.alfil.co/v1/electoral/puestos
  • 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, alcalde-2023-medellin) o id interno numérico

departamentostring

Departamento del municipio (accent-insensitive). Requerido salvo que el código de elección ya lo traiga embebido (p. ej. alcalde-2023-medellin)

municipiostring required

Nombre del municipio (requerido) + departamento resuelto

candidatostring

Cédula del candidato para agregar votos_candidato por puesto. Cruce legítimo de control social (ADR-020).

partidostring

Slug del partido (catálogo de Alfil) para agregar votos_partido por puesto

Response

Puestos con geolocalización

Example response

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