Datos
Dos consultas de solo lectura sobre la tabla facts, en JSON y con la misma cifra en CSV (?format=csv): no hay clave, no hay escritura y cada valor procede del informe ESEF que lo publicó.
Cifras de una empresa
GET /api/companyfacts/{lei}
Todas las cifras que la tabla tiene de un emisor, agrupadas por taxonomía, concepto y unidad (la forma de companyfacts de la SEC). Cada valor lleva su informe de origen, su SHA-256 y, si el ejercicio se presentó más de una vez, la marca reexpresado.
Parámetros
lei: LEI de 20 caracteres del emisor, p. ej. 5QK37QC7NWOJ8D7WVQ45: 404 si la tabla no tiene hechos de esa LEI.format=csv: variante CSV equivalente al JSON: cabecera con las columnas y una fila por cifra.
Ejemplo de respuesta
{
"lei": "5QK37QC7NWOJ8D7WVQ45",
"facts": {"ifrs-full": {"Revenue": {"units": {"EUR": [
{"start": "2024-01-01", "end": "2024-12-31", "val": 44739000000.0,
"fxo_id": "5QK37QC7NWOJ8D7WVQ45-2024-12-31-ESEF-ES-0", "filed": "2025-05-08",
"sha256": "89dfd3ef…", "report_url": "https://filings.xbrl.org/…"}
]}}}}}
Una cifra, todas las empresas
GET /api/frames/{concepto}/{periodo}
Un concepto en todas las empresas de un ejercicio: una fila por empresa con la presentación vigente (la más reciente por fecha de presentación), su informe, su SHA-256 y, si el ejercicio se presentó más de una vez, reexpresado con el informe anterior. Solo hechos sin dimensiones.
Parámetros
concepto: concepto XBRL con su taxonomía, p. ej. ifrs-full:Revenue: 404 si nadie lo publica en el periodo (nadie publica, nunca un cero).periodo: ejercicio como CY<aaaa>, p. ej. CY2024: 422 si no tiene esa forma y 404 si no hay cifras de ese ejercicio.format=csv: variante CSV equivalente al JSON: cabecera y una fila por empresa, ordenada por LEI.
Ejemplo de respuesta
[
{"lei": "5QK37QC7NWOJ8D7WVQ45", "concept": "ifrs-full:Revenue",
"start": "2024-01-01", "end": "2024-12-31", "val": 44739000000.0, "unit": "EUR",
"fxo_id": "5QK37QC7NWOJ8D7WVQ45-2024-12-31-ESEF-ES-0", "filed": "2025-05-08",
"sha256": "89dfd3ef…", "report_url": "https://filings.xbrl.org/…",
"reexpresado": false}
]