---
title: "Resultados electorales"
method: GET
path: "/v1/electoral/resultados"
tags: ["Electoral"]
---

# Resultados electorales

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

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

## Query parameters

- `cursor` integer
- `limit` integer
- `eleccion` string, required
- `departamento` string
- `municipio` string
- `zona` string
- `puesto` string
- `orden` 'votos_desc'
- `partido` string

## Response `200`

Resultados por ámbito

- ResultadosElectorales
  - `eleccion` object, required
    - `codigo` string, required
    - `nombre` string, required
  - `ambito` AmbitoGeografico, required: Ámbito consultado, ecoado con código DIVIPOLA + nombre
    - `nivel` 'nacional' | 'departamento' | 'municipio' | 'zona' | 'puesto' | 'mesa', required
    - `departamento` object
      - `divipola` string, required
      - `nombre` string, required
    - `municipio` object
      - `divipola` string, required
      - `nombre` string, required
    - `zona` object: Zona/localidad; `divipola` es el id interno, NO un código DIVIPOLA oficial
      - `divipola` string, required
      - `nombre` string, required
    - `puesto` object: Puesto de votación; `divipola` es el id interno, NO un código DIVIPOLA oficial
      - `divipola` string, required
      - `nombre` string, required
  - `resultados` ResultadoCandidato[], required
    - `candidato` string, required
    - `partido` string, required
    - `votos` string, required: Votos (bigint como string)
    - `porcentaje` number
    - `ranking` string: Posición en el ranking (bigint como string)
    - `is_elected` boolean: Si el candidato resultó electo
  - `page` Page, required: Paginación por cursor opaco (no offset)
    - `cursor` string, nullable, required: Cursor opaco de la siguiente página; null si no hay más
    - `has_more` boolean, required: Indica si existen más resultados
  - `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)