Skip to main content
ES FR / API · Spain

Build on Spain filings programmatically.

A typed REST API over 45,505 filings from 321 Spanish listed companies — JSON metadata, Markdown body, and original PDF. Webhooks on every new release.

Public-company filings in Spain are supervised by Comisión Nacional del Mercado de Valores (CNMV). Reporting follows IFRS (consolidated); Spanish GAAP (separate). Filings are most commonly published in Spanish and English. Major issuers are listed on IBEX 35, IBEX Medium Cap and IBEX Small Cap. Calendar year predominant.

Building on Spanish filings programmatically

The FinancialReports API delivers CNMV-supervised Spanish filings through the same single REST surface, one x-api-key header, and one shared rate-limit bucket used across all 42 covered markets. A Spain-only integration is a one-parameter filter (?country=ES) on the global filings endpoint — no separate Spanish API key, no parallel billing tier, and no per-country infrastructure. The same endpoint serves IBEX 35 annual reports, CNMV insider-transaction notifications, and BME Growth admission documents.

For live pipelines the webhook channel is the recommended path: subscribe once, receive a POST with full filing metadata within roughly 60 seconds of CNMV publication. The webhook payload shape is identical across all covered markets, so a Spanish Información Privilegiada announcement arrives at your endpoint with the same JSON envelope as a French AMF filing or a German BaFin ad-hoc. Country routing is handled server-side; consumer code stays market-agnostic. Volume is highest in February–April (annual report season) and spikes intraday around earnings and M&A announcements.

Filing bodies are available as JSON metadata, Markdown via /api/filings/{id}/markdown/, and original PDF or iXBRL. The Markdown rendering is particularly relevant for Spanish content — CNMV PDF layouts and table structures vary substantially across issuers; the processed text normalises that into a consistent, parseable form suitable for NLP pipelines, LLM context windows, and search indexes without a separate extraction step. iXBRL is preserved for ESEF-mandated annual reports, retaining machine-readable financial line-items where the regulator requires them.

Common API integrations for Spanish data include backfilling IBEX 35 and IBEX Medium Cap consolidated financials for quant research, triggering on Información Privilegiada disclosures (profit warnings, dividend changes, M&A), monitoring significant-shareholding threshold crossings, tracking BME Growth admission events, and feeding Spanish-language filings into bilingual analyst tools. Trial keys are available on request; the web product is free and indexed for the public web, so coverage and filing quality are verifiable before integration.

Filings indexed
45,505
in Spain
Listed companies
321
Spanish issuers
Auth
x-api-key
single header
Webhook latency
< 1 min
from regulator publish

Reporting at a glance — Spain

Regulator, indices, accounting, language
Primary indices
IBEX 35IBEX Medium CapIBEX Small Cap
Accounting standards
IFRS (consolidated); Spanish GAAP (separate)
Reporting languages
SpanishEnglish
Fiscal year
Calendar year predominant

Quick start — Spain filings

REST · JSON · Markdown · PDF
# 1. List filings for Spain, newest first
curl "https://api.financialreports.eu/api/filings/?countries=ES" \
    -H "x-api-key: $FR_API_KEY"

# 2. Pull full Markdown for one filing
curl https://api.financialreports.eu/api/filings/<id>/markdown/ \
    -H "x-api-key: $FR_API_KEY"

# 3. Filter by filing type — annual reports only
curl "https://api.financialreports.eu/api/filings/?countries=ES&type=10-K" \
    -H "x-api-key: $FR_API_KEY"

# 4. Filter by ISIN (single issuer)
curl "https://api.financialreports.eu/api/filings/?company_isin=DE000A1EWWW0" \
    -H "x-api-key: $FR_API_KEY"

Full API documentation ↗ · Interactive Swagger ↗

Sample Spain response

Real filings · live data
Filing Type Released
Ejecución programa de recompra 27 a 30 abril Viscofan S.A. · VIS Regulatory Filings 2026-05-04
Contratos de liquidez: información periódica (1 febrero 2026 - 30 abril 2026) Indra Sistemas S.A. · IDR Regulatory Filings 2026-05-04
Colonial SFL comunica que realizará el 14 de mayo de 2026 una presentación vía video webcast con audio conferencia, para comentar los resultados del primer trimestre de 2026, previa publicación de res Inmobiliaria Colonial Socimi S.A. · COL Regulatory Filings 2026-05-04
Banco Sabadell informa de las operaciones sobre acciones propias que ha realizado entre los días 27 de abril de 2026 y 30 de abril de 2026 bajo el programa de recompra. Banco Sabadell S.A. · SAB Regulatory Filings 2026-05-04
La Sociedad remite información relativa a la ejecución de su programa de recompra de acciones propias Cellnex Telecom S.A. · CLNX Regulatory Filings 2026-05-04
La Sociedad informa del otorgamiento de la escritura de ejecución de ampliación de capital dineraria con derecho de suscripción preferente Grupo Ezentis S.A. · EZE Regulatory Filings 2026-05-04
Programa de recompra de acciones Endesa S.A. · ELE Regulatory Filings 2026-05-04
Presentación de resultado Grupo Prim primer trimestre 2026 Prim S.A. · PRM Regulatory Filings 2026-05-04
La sociedad remite el Informe Anual de Gobierno Corporativo del ejercicio 2025 Urbar Ingenerios, S.A. · UIN Regulatory Filings 2026-05-04
VIDRALA comunica las operaciones efectuadas al amparo de su programa de recompra de acciones entre el 29 y 30 de abril de 2026. Vidrala S.A. · VID Regulatory Filings 2026-05-04

Get API access for Spain

Pricing · trial keys · enterprise
Get API access Talk to the team Read the docs ↗

Filings activity by year

Last 6 years · Spanish issuers
  • 2026 4,504
  • 2025 5,147
  • 2024 5,041
  • 2023 4,898
  • 2022 4,926
  • 2021 4,849

Reporting languages

Filing-by-filing distribution
  • Spanish 28,048
  • English 13,682
  • Polish 1,794
  • Turkish 1,336
  • Portuguese 227

FAQ — Spain

Coverage, formats, integration
How do I authenticate API requests for Spain filings?
Send a single header — `x-api-key: $FR_API_KEY` — on every request. The same key works across all 42 covered markets; there's no per-country key.
What format does the Spain API return?
Filing metadata is returned as JSON. Full filing bodies are available as Markdown (one endpoint) and original PDF. The same payload shape is used across every covered market.
Do you provide webhooks for new Spanish filings?
Yes. Webhook subscribers receive a POST with full filing metadata within ~60 seconds of the regulator publishing the document.
Is there a rate limit on the Spanish API?
Standard plans are throttled to a generous request budget that suits typical research and dashboards. Bulk and high-throughput plans negotiate higher limits.
Is there a free tier for Spain data?
The web product (search, browse, single-filing read) is free and indexed for the public web. Programmatic API access is a paid plan; trial keys are available on request.