---
title: "Buscar votaciones del Congreso"
method: GET
path: "/v1/congreso/votaciones"
tags: ["Congreso"]
---

# Buscar votaciones del Congreso

`GET /v1/congreso/votaciones`

## Request

- Base URL: `https://api.alfil.co`
- URL: `https://api.alfil.co/v1/congreso/votaciones`
- Auth: OAuth 2 (authorization code, authorization URL `https://api.alfil.co/oauth/authorize`, token URL `https://api.alfil.co/oauth/token`, scopes: `buscar:read`)

Votaciones nominales por tema (vocabulario cerrado) y fecha, con el id que acepta el detalle.

## Query parameters

- `cursor` integer
- `limit` integer
- `tema` 'Paz y posconflicto' | 'Reforma pensional' | 'Reforma laboral' | 'Reforma a la salud' | 'Presupuesto y hacienda' | 'Justicia' | 'Seguridad y defensa' | 'Ambiente y clima' | 'Educación' | 'Derechos humanos' | 'Tierras y agro' | 'Anticorrupción' | 'Régimen político' | 'Relaciones exteriores' | 'Vivienda y territorio' | 'Transporte e infraestructura' | 'Economía y comercio' | 'Honores y conmemoraciones'

## Response `200`

Votaciones en listado

- VotacionesResponse
  - `data` VotacionListItem[], required
    - `id` string, required
    - `motivo` string, nullable, required
    - `fecha` string, nullable, required
    - `referencias` Referencia[], required
      - `tipo` 'pagina_alfil' | 'registro_oficial' | 'documento_oficial' | 'coleccion_oficial', required
      - `titulo` string, required
      - `url` string, uri, required
      - `proveedor` string, required
      - `id_externo` string
  - `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)