EU Annual Reports API (ESEF): XBRL financial statements

Get normalized key financials from the official ESEF annual reports of European listed companies, by LEI, company name, country or fiscal year: revenue, EBIT, EBITDA, net income, EPS, dividends, balance sheet and cash flows, plus margins, return on equity and revenue growth versus the prior year. Every number comes with the exact XBRL fact it was taken from and a link to the annual report viewer, so you can audit any value in one click. For equity analysts, finance apps and AI agents that need comparable numbers for European listed companies.

Pricing (pay per event): $0.01 per run plus $0.05 per annual report ($50 per 1,000 reports). Each report includes the comparative prior year at no extra cost. Raw XBRL fact rows, if you switch them on, cost $0.0005 each. You only pay for reports delivered, the same fiscal year is never charged twice, and the Actor stops at your max charge limit.

Questions agents ask

• “Get Heineken's latest revenue growth and operating margin from its annual report.”
• “Compare net income and equity of Belgian listed companies for fiscal years ending in 2024.”
• “Which XBRL fact does ASML's reported revenue come from?”

What you get

Coverage

ESEF annual reports collected by filings.xbrl.org: 27,626 reports from 28 countries (counted 2026-11-05; largest: UA, GB, DK, SE, NO, FR, FI). Germany is not in the index. Reports appear a few days to a few weeks after publication, once filings.xbrl.org has processed them. All values are in full currency units.

Use with AI agents (MCP)

Add this URL to your MCP client (Claude, Cursor, VS Code, ...) to load the Actor as a tool through the Apify hosted MCP server. It signs you in with OAuth or accepts Authorization: Bearer <APIFY_TOKEN>.

https://mcp.apify.com?tools=bosco_labs/esef-annual-reports

For “Get Heineken's latest revenue growth and operating margin from its annual report.” the agent passes:

{"companyName": "heineken", "maxFilings": 1}

stable, typed JSON, one row per annual report. Every row has schema_version and a source_url pointing to the report's xBRL-JSON on filings.xbrl.org (plus viewer_url and a sources entry per value), so the agent can cite its source. An LEI or name search covers every country; if nothing matches, the run's status message says so.

Or call the Apify API: POST https://api.apify.com/v2/acts/bosco_labs~esef-annual-reports/run-sync-get-dataset-items with the input as JSON body. Cost: $0.01 per run plus $0.05 per annual report; raw XBRL fact rows, if switched on, $0.0005 each.

Input fields

Sources, licence and limits

Which countries? All 28 countries in the filings.xbrl.org index, listed above. Germany is not in the index (0 filings). Most testing was done on NL, BE and FR reports; reports from countries with their own IFRS taxonomy variant (e.g. Ukraine) may have fewer standard fields filled. metrics_found tells you how complete a row is.

How fresh? Reports appear a few days to a few weeks after publication, once filings.xbrl.org has processed them.

Why are some fields empty? Companies tag their statements differently. Some use their own (extension) concepts instead of the standard IFRS ones; those stay null rather than being guessed. For example, LVMH tags no standard operating profit, so its operating margin and EBITDA are empty too.

Number of employees? ESEF reports almost never tag the headcount as a number (it sits in text notes), so it isn't included. employee_benefits_expense (total staff costs) is.

Are the numbers in thousands? No. All values are in full currency units (XBRL canonical values), per-share figures are per share, and ratios are fractions (0.25 = 25%).

Legal basis? These are public regulatory disclosures, and filings.xbrl.org currently places no restrictions on use. Raw fact rows can contain names from notes such as directors' remuneration; if you process those, you are responsible for your own legal basis under GDPR.