---
title: "Puestos de votación geolocalizados"
method: GET
path: "/v1/electoral/puestos"
tags: ["Electoral"]
---

# Puestos de votación geolocalizados

`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`)

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

## Query parameters

- `eleccion` string, required
- `departamento` string
- `municipio` string, required
- `candidato` string
- `partido` string

## Response `200`

Puestos con geolocalización

- ElectoralMapa
  - `eleccion` object, required
    - `codigo` string, required
    - `nombre` string, required
  - `municipio` object, required
    - `divipola` string, required
    - `nombre` string, required
  - `candidato` object
    - `cedula` string, required
    - `nombre` string, required
  - `partido` object
    - `slug` string, required
    - `nombre` string, required
  - `puestos` PuestoMapa[], required
    - `id` string, required
    - `nombre` string, required
    - `direccion` string, nullable, required
    - `lat` number, nullable, required
    - `lng` number, nullable, required
    - `votos_totales` string, required: Votos totales del puesto (bigint como string)
    - `votos_candidato` string: Presente solo si se filtró por candidato
    - `votos_partido` string: Presente solo si se filtró por partido
    - `mesas` number, nullable, required
    - `habilitados` number, nullable, required: Censo electoral habilitado en el puesto
  - `referencias` Referencia[], required: Enlaces navegables a Alfil derivados del filtro aplicado (p. ej. el perfil del partido); vacío si el mapa no fue filtrado por una entidad navegable
    - `tipo` 'pagina_alfil' | 'registro_oficial' | 'documento_oficial' | 'coleccion_oficial', required
    - `titulo` string, required
    - `url` string, uri, required
    - `proveedor` string, required
    - `id_externo` string
  - `fuente` Fuente, required: Proveniencia: fuente oficial y fecha de corte (atribución Ley 1712)
    - `nombre` string, required: Fuente oficial del dato
    - `url` string: URL de la fuente oficial
    - `corte` string, required: Fecha de corte del dato (ISO 8601)
    - `licencia` string: Licencia de la fuente

## Other responses

- `401`: Token faltante, expirado o de emisor inesperado
- `403`: Scope insuficiente
- `429`: Cuota agotada o rate limit

---

[API](https://skmtc.dev/alfil/apis/alfil-api.md) · [All operations](https://skmtc.dev/alfil/apis/alfil-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alfil/apis/alfil-api/revisions/e2545a4c45a5?raw)