All APIs

ESEF API for annual company filings

Get annual financial statements for about 3,200 companies.

First request

Quickstart →
curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/nld:724500Y6DUVHQD6OXN27/financials?period=annual&fields=revenue,net_income,total_assets" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
Example response Illustrative response · not a live request
{
  "id": "nld:724500Y6DUVHQD6OXN27",
  "currency": "EUR",
  "annual": [
    {
      "fy": 2025,
      "end": "2025-12-31",
      "derived": [],
      "revenue": "32667300000",
      "net_income": "10213000000",
      "total_assets": "55576800000"
    }
  ],
  "as_of": "2026-02-25"
}

Endpoints

GETList companies/v1/companies
GETList a company's filings/v1/companies/{company_id}/filings
GETGet standardised company financial statements/v1/companies/{company_id}/financials

EU and EEA annual coverage

Choose statement fields

Select statement items with fields=revenue,net_income,total_assets.

Annual reports only

Use period=annual to request annual statements.

Currencies as filed

Amounts remain in the currency each company reports in, as filed.

Coverage

View coverage →

Reports use the European Single Electronic Format (ESEF) and cover 26 EU and EEA countries. Coverage excludes Germany, Ireland, Bulgaria and Liechtenstein.

Explore related pages

UK filings API for companies on regulated markets

Annual reports from issuers on UK regulated markets

Explore the API →

MOPS API for Taiwan filings and statements

Taiwan company financials from TWSE OpenAPI and TPEx open data on data.gov.tw

Explore the API →

SEC EDGAR API through Narwhal

Live US filings and standardised XBRL financials from SEC EDGAR

Explore the API →

Company filings API for lists and individual records

Filing lists, individual records and the latest filings across companies

Explore the API →

Common questions

How do ESEF company IDs work?

Company IDs combine the country code and the company's LEI, such as nld:<LEI>. A company listed in two countries can appear under each country.

Are quarterly or half-year statements included?

No. Coverage is annual reports only, with no quarterly or half-year statements.

Are holders of 5% or more included?

No. Holders of 5% or more are not included for these companies.