Saltar al contenido

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.

URL base
https://reforma-digital.es/api/congreso

Autenticació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.

Respuesta 200
{
  "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

Respuesta 200
{
  "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ámetroDescripciónPor defecto
pagina enteroNúmero de página, empezando por 1.1
limite enteroResultados por página, entre 1 y 100.24
legislatura textoLegislatura en números romanos.XV
desde fechaFecha mínima en formato AAAA-MM-DD.—
hasta fechaFecha máxima en formato AAAA-MM-DD.—
q textoFiltra por el título, hasta 200 caracteres.—

Petición

curl "https://reforma-digital.es/api/congreso/votaciones?q=vivienda&limite=5"

Respuesta

Respuesta 200
{
  "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ámetroDescripciónPor defecto
legislatura textoLegislatura en números romanos.XV

Petición

curl "https://reforma-digital.es/api/congreso/votaciones/<id>"

Respuesta

Respuesta 200
{
  "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ámetroDescripciónPor defecto
pagina enteroNúmero de página, empezando por 1.1
limite enteroResultados por página, entre 1 y 100.24
legislatura textoLegislatura en números romanos.XV
desde fechaFecha mínima en formato AAAA-MM-DD.—
hasta fechaFecha máxima en formato AAAA-MM-DD.—
q textoFiltra por el título, hasta 200 caracteres.—
estado textoFiltra por el estado exacto de la pregunta.—

Petición

curl "https://reforma-digital.es/api/congreso/preguntas?q=sanidad"

Respuesta

Respuesta 200
{
  "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ámetroDescripciónPor defecto
pagina enteroNúmero de página, empezando por 1.1
limite enteroResultados por página, entre 1 y 100.24
legislatura textoLegislatura en números romanos.XV
desde fechaFecha mínima en formato AAAA-MM-DD.—
hasta fechaFecha máxima en formato AAAA-MM-DD.—
q textoFiltra por el nombre del órgano.—

Petición

curl "https://reforma-digital.es/api/congreso/sesiones?q=pleno&desde=2025-01-01"

Respuesta

Respuesta 200
{
  "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ámetroDescripciónPor defecto
legislatura textoLegislatura en números romanos.XV

Petición

curl "https://reforma-digital.es/api/congreso/sesiones/DSCD-15-PL-1"

Respuesta

Respuesta 200
{
  "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
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ódigoDescripción
400Un parámetro, una ruta o un identificador no tiene un formato válido.
404El endpoint o el recurso solicitado no existe.
451Las encuestas y la descarga completa no están disponibles durante el periodo de veda electoral.
502El archivo de la descarga completa no está disponible en este momento.
503Los 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
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.