API de Reforma Digital
La API de Reforma Digital sirve de forma abierta los datos del Congreso de los Diputados: las votaciones del Pleno con el voto de cada diputado, las preguntas parlamentarias, los Diarios de Sesiones y los datasets que alimentan la web. Es una API REST de solo lectura que responde en JSON.
https://reforma-digital.es/api/congresoAutenticación
La API no requiere autenticación ni claves de acceso. Todas las peticiones son GET y las respuestas incluyen Access-Control-Allow-Origin: *, así que puede consumirse desde un servidor o directamente desde el navegador.
curl "https://reforma-digital.es/api/congreso/votaciones?q=vivienda&limite=5"Paginación
Los endpoints de listado se paginan con los parámetros pagina y limite. Cada respuesta indica la página devuelta y el número total de resultados.
{
"pagina": 1,
"limite": 24,
"total": 318,
"resultados": [ … ]
}Para recorrer un listado completo, incrementa pagina hasta haber leído total resultados.
Obtener el índice
GET/api/congreso
Devuelve la versión de la API, la última publicación de datos, los datasets disponibles con su hash SHA-256 y la atribución que debe acompañar a cualquier uso de los datos.
Petición
curl "https://reforma-digital.es/api/congreso"Respuesta
{
"version": 1,
"atribucion": { "origen": "Escaño Abierto", "licencia": "CC BY 4.0", … },
"publicacion": { "id": "…", "created_at": "…", "counts": { … } },
"conjuntos": [{ "path": "leyes.json", "sha256": "…", "updated_at": "…" }],
"endpoints": ["datasets/<ruta.json>", "votaciones", …]
}Listar votaciones
GET/api/congreso/votaciones
Devuelve las votaciones del Pleno ordenadas de la más reciente a la más antigua, con el recuento de votos de cada sentido.
Parámetros de consulta
| Parámetro | Descripción | Por defecto |
|---|---|---|
pagina entero | Número de página, empezando por 1. | 1 |
limite entero | Resultados por página, entre 1 y 100. | 24 |
legislatura texto | Legislatura en números romanos. | XV |
desde fecha | Fecha mínima en formato AAAA-MM-DD. | — |
hasta fecha | Fecha máxima en formato AAAA-MM-DD. | — |
q texto | Filtra por el título, hasta 200 caracteres. | — |
Petición
curl "https://reforma-digital.es/api/congreso/votaciones?q=vivienda&limite=5"Respuesta
{
"pagina": 1, "limite": 5, "total": 42,
"resultados": [{
"id": "…", "legislature": "XV", "date": "2025-03-12",
"title": "…", "kind": "…", "initiative": "…",
"yes_count": 172, "no_count": 170, "abstention_count": 1,
"absent_count": 7, "topics": […]
}]
}Obtener una votación
GET/api/congreso/votaciones/<id>
Devuelve una votación y el voto individual de cada diputado. El campo voto toma los valores S (sí), N (no), A (abstención) y X (no vota).
Parámetros de consulta
| Parámetro | Descripción | Por defecto |
|---|---|---|
legislatura texto | Legislatura en números romanos. | XV |
Petición
curl "https://reforma-digital.es/api/congreso/votaciones/<id>"Respuesta
{
"votacion": { "id": "…", "title": "…", "yes_count": 172, … },
"votos": [{ "diputado": "…", "grupo": "…", "voto": "S" }]
}Listar preguntas
GET/api/congreso/preguntas
Devuelve las preguntas parlamentarias con su número de expediente, sus autores y su estado de tramitación.
Parámetros de consulta
| Parámetro | Descripción | Por defecto |
|---|---|---|
pagina entero | Número de página, empezando por 1. | 1 |
limite entero | Resultados por página, entre 1 y 100. | 24 |
legislatura texto | Legislatura en números romanos. | XV |
desde fecha | Fecha mínima en formato AAAA-MM-DD. | — |
hasta fecha | Fecha máxima en formato AAAA-MM-DD. | — |
q texto | Filtra por el título, hasta 200 caracteres. | — |
estado texto | Filtra por el estado exacto de la pregunta. | — |
Petición
curl "https://reforma-digital.es/api/congreso/preguntas?q=sanidad"Respuesta
{
"pagina": 1, "limite": 24, "total": 318,
"resultados": [{
"exp": "…", "presentada": "2025-02-03", "titulo": "…",
"estado": "…", "autores": [["…", "…"]]
}]
}Listar sesiones
GET/api/congreso/sesiones
Devuelve los Diarios de Sesiones del Pleno y de las comisiones, con el número de intervenciones de cada uno.
Parámetros de consulta
| Parámetro | Descripción | Por defecto |
|---|---|---|
pagina entero | Número de página, empezando por 1. | 1 |
limite entero | Resultados por página, entre 1 y 100. | 24 |
legislatura texto | Legislatura en números romanos. | XV |
desde fecha | Fecha mínima en formato AAAA-MM-DD. | — |
hasta fecha | Fecha máxima en formato AAAA-MM-DD. | — |
q texto | Filtra por el nombre del órgano. | — |
Petición
curl "https://reforma-digital.es/api/congreso/sesiones?q=pleno&desde=2025-01-01"Respuesta
{
"pagina": 1, "limite": 24, "total": 96,
"resultados": [{
"id": "DSCD-15-PL-1", "date": "2023-08-17",
"organo": "Pleno", "intervenciones": 84
}]
}Obtener una sesión
GET/api/congreso/sesiones/<id>
Devuelve una sesión con todas sus intervenciones. El identificador tiene la forma DSCD-15-PL-1, donde PL identifica el Pleno y CO las comisiones.
Parámetros de consulta
| Parámetro | Descripción | Por defecto |
|---|---|---|
legislatura texto | Legislatura en números romanos. | XV |
Petición
curl "https://reforma-digital.es/api/congreso/sesiones/DSCD-15-PL-1"Respuesta
{
"id": "DSCD-15-PL-1", "fecha": "2023-08-17", "ds": "https://…",
"intervenciones": [{ "orador": "…", "grupo": "…", "texto": "…", "item": "…" }]
}Obtener un dataset
GET/api/congreso/datasets/<ruta.json>
Devuelve uno de los archivos originales que alimentan la web, como leyes.json, temas.json o elecciones/historico.json. La lista completa de rutas está en el campo conjuntos del índice. Las respuestas incluyen ETag.
Petición
curl "https://reforma-digital.es/api/congreso/datasets/leyes.json"Descargar el histórico completo
GET/api/congreso/descarga
Devuelve el histórico completo en un único archivo .tar.gz. Es la forma recomendada de obtener todos los datos en lugar de recorrer los listados.
Petición
curl -o congreso.tar.gz "https://reforma-digital.es/api/congreso/descarga"Errores
La API usa los códigos de estado HTTP habituales. Las respuestas de error incluyen un cuerpo { "error": "…" } que describe el motivo.
| Código | Descripción |
|---|---|
400 | Un parámetro, una ruta o un identificador no tiene un formato válido. |
404 | El endpoint o el recurso solicitado no existe. |
451 | Las encuestas y la descarga completa no están disponibles durante el periodo de veda electoral. |
502 | El archivo de la descarga completa no está disponible en este momento. |
503 | Los datos no están disponibles temporalmente. Reintenta más tarde. |
Caché
Los datasets devuelven una cabecera ETag con su hash. Envíala en If-None-Match para recibir un 304 Not Modified sin cuerpo cuando el archivo no haya cambiado. Guarda las respuestas en caché y, si necesitas todos los datos, usa la descarga completa.
curl -H 'If-None-Match: "<sha256>"' "https://reforma-digital.es/api/congreso/datasets/leyes.json"Licencia y atribución
Los datos se distribuyen con licencia CC BY 4.0, salvo las encuestas, que se distribuyen con CC BY-SA 4.0. Cualquier uso debe citar la fuente que indica el campo atribucion del índice. Los resúmenes y la clasificación por temas se generan con IA y pueden contener errores: los documentos oficiales del Congreso son la referencia.