{"openapi":"3.1.0","info":{"title":"API Consejo de Ministros — Son Tus Impuestos","version":"1.0.0","description":"API pública y abierta para consulta programática y descarga masiva de los acuerdos, decretos y sesiones del Consejo de Ministros de España.","contact":{"name":"Son Tus Impuestos — Auditoría Ciudadana","url":"https://sontusimpuestos.com"},"license":{"name":"Reutilización de Información del Sector Público (Ley 37/2007)","url":"https://www.boe.es/buscar/act.php?id=BOE-A-2007-20063"}},"servers":[{"url":"/api/v1/consejo","description":"Servidor principal API v1"}],"paths":{"/acuerdos":{"get":{"summary":"Listar y buscar acuerdos del Consejo","description":"Devuelve un listado paginado de acuerdos con soporte para búsqueda textual completa (FTS) en español, filtros por año, fecha, etiqueta y titular principal.","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"},"description":"Búsqueda textual en español (título y contenido)"},{"name":"year","in":"query","required":false,"schema":{"type":"integer"},"description":"Filtrar por año (ej: 2026)"},{"name":"tag","in":"query","required":false,"schema":{"type":"string"},"description":"Filtrar por etiqueta temática (ej: Vivienda, Transportes)"},{"name":"date","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Fecha exacta de la reunión en formato YYYY-MM-DD"},{"name":"dateFrom","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Fecha mínima de celebración (YYYY-MM-DD)"},{"name":"dateTo","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Fecha máxima de celebración (YYYY-MM-DD)"},{"name":"isLead","in":"query","required":false,"schema":{"type":"boolean"},"description":"Filtrar solo titulares principales (true / false)"},{"name":"sortBy","in":"query","required":false,"schema":{"type":"string","enum":["date_desc","date_asc","views_desc","relevance"],"default":"date_desc"},"description":"Criterio de ordenación"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1},"description":"Número de página (inicia en 1)"},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","default":20,"maximum":100},"description":"Cantidad de elementos por página (máx. 100)"}],"responses":{"200":{"description":"Listado de acuerdos obtenido con éxito","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Agreement"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}}}}}}}}},"/acuerdos/{id}":{"get":{"summary":"Obtener detalle de un acuerdo","description":"Consulta un acuerdo individual a través de su UUID o su slug amigable.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"UUID o slug del acuerdo"}],"responses":{"200":{"description":"Acuerdo encontrado","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"$ref":"#/components/schemas/Agreement"}}}}}},"404":{"description":"Acuerdo no encontrado"}}}},"/sesiones":{"get":{"summary":"Listar sesiones semanales de Consejo de Ministros","description":"Devuelve las reuniones celebradas agrupadas por fecha, con titulares y enlaces oficiales.","parameters":[{"name":"year","in":"query","required":false,"schema":{"type":"integer"},"description":"Filtrar por año (ej: 2026)"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"Listado de sesiones obtenido con éxito","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"array","items":{"$ref":"#/components/schemas/Session"}},"meta":{"$ref":"#/components/schemas/PaginationMeta"}}}}}}}}},"/sesiones/{date}":{"get":{"summary":"Obtener una sesión concreta y todos sus acuerdos","parameters":[{"name":"date","in":"path","required":true,"schema":{"type":"string","format":"date"},"description":"Fecha de la sesión en formato YYYY-MM-DD (ej: 2026-09-15)"}],"responses":{"200":{"description":"Sesión encontrada con todos sus acuerdos","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"session":{"$ref":"#/components/schemas/Session"},"agreements":{"type":"array","items":{"$ref":"#/components/schemas/Agreement"}}}}}}}}},"404":{"description":"Sesión no encontrada"}}}},"/catalogo":{"get":{"summary":"Estadísticas y metadatos del catálogo","description":"Totales de acuerdos, sesiones, rango histórico y etiquetas más frecuentes.","responses":{"200":{"description":"Catálogo obtenido con éxito","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"data":{"type":"object","properties":{"total_agreements":{"type":"integer"},"total_sessions":{"type":"integer"},"date_range":{"type":"object","properties":{"min_date":{"type":"string"},"max_date":{"type":"string"}}},"years":{"type":"array"},"popular_tags":{"type":"array"}}}}}}}}}}},"/descargas":{"get":{"summary":"Descarga masiva de datos en streaming (CSV, JSON, NDJSON)","description":"Permite descargar grandes volúmenes de acuerdos sin límites de paginación. Devuelve archivos con cabecera Content-Disposition: attachment.","parameters":[{"name":"format","in":"query","required":false,"schema":{"type":"string","enum":["csv","json","ndjson"],"default":"csv"},"description":"Formato de archivo a exportar"},{"name":"year","in":"query","required":false,"schema":{"type":"integer"},"description":"Año a exportar (si se omite, exporta todo el histórico)"},{"name":"tag","in":"query","required":false,"schema":{"type":"string"},"description":"Filtrar por etiqueta temática"},{"name":"includeContent","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Incluir cuerpo del artículo (true / false)"}],"responses":{"200":{"description":"Descarga en streaming del dataset","content":{"text/csv":{"schema":{"type":"string","format":"binary"}},"application/json":{"schema":{"type":"string","format":"binary"}},"application/x-ndjson":{"schema":{"type":"string","format":"binary"}}}}}}}},"components":{"schemas":{"Agreement":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"council_date":{"type":"string","format":"date"},"year":{"type":"integer"},"title":{"type":"string"},"original_title":{"type":"string"},"subtitle":{"type":"string"},"content":{"type":"string"},"moncloa_url":{"type":"string","format":"uri"},"tags":{"type":"array","items":{"type":"string"}},"views_count":{"type":"integer"},"is_lead_story":{"type":"boolean"},"public_url":{"type":"string"},"created_at":{"type":"string","format":"date-time"},"updated_at":{"type":"string","format":"date-time"}}},"Session":{"type":"object","properties":{"council_date":{"type":"string","format":"date"},"year":{"type":"integer"},"total_agreements":{"type":"integer"},"lead_story":{"type":"object","properties":{"title":{"type":"string"},"slug":{"type":"string"},"public_url":{"type":"string"}}},"moncloa_url":{"type":"string","format":"uri"},"tags":{"type":"array","items":{"type":"string"}}}},"PaginationMeta":{"type":"object","properties":{"page":{"type":"integer"},"pageSize":{"type":"integer"},"totalCount":{"type":"integer"},"totalPages":{"type":"integer"}}}}}}