For developers

REST API

Use the same data in scripts and applications: endpoints, parameters, and responses.

Base URL

REST base URL

https://api.eurofindata.com/v1

Send your account API key in the bearer Authorization header. All endpoints below use GET and return JSON. See authentication for key management.

Companies

GET/v1/companies/

List company profiles.

Optional: country (ISO code), limit (1–1,000), offset.

GET/v1/companies/search

Search by name, ticker, ISIN, or LEI. Returns an array of matching profiles.

Required: q. Optional: country, limit (1–100).

GET/v1/companies/{identifier}

Resolve one company by ticker, TICKER.MIC, ISIN, LEI, or name.

cURL

curl 'https://api.eurofindata.com/v1/companies/ASML' \  -H "Authorization: Bearer $EUROFINDATA_API_KEY"

Financial statements

The statement endpoints accept a company identifier as ticker.

GET/v1/financials/income-statements

Income statement line items.

GET/v1/financials/balance-sheets

Assets, liabilities, and equity.

GET/v1/financials/cash-flow-statements

Operating, investing, and financing cash flows.

GET/v1/financials/metrics

Available financial metrics.

Statement parameter	Description
`ticker`	Required company identifier.
`period`	Optional: annual, semi_annual, or quarterly.
`limit`	1–100 records; default 10.
`report_period_gte` `report_period_lte`	Optional date bounds in YYYY-MM-DD format.
`currency`	Optional target currency for statement conversion.

cURL

curl 'https://api.eurofindata.com/v1/financials/balance-sheets?ticker=ASML&period=annual&limit=1' \  -H "Authorization: Bearer $EUROFINDATA_API_KEY"

Read the named response array: income_statements, balance_sheets, or cash_flow_statements. Preserve each record’s report period, currency, source, and null values.

Other datasets

These routes are available in the installed engine. Their filters differ by dataset; use the engine’s OpenAPI schema for the exact parameters and response fields.

GET/v1/screen

Screen companies using supported country, sector, and financial filters.

GET/v1/prices/history

Daily OHLCV price history.

GET/v1/dividends

Dividend history.

GET/v1/stock-splits

Stock split history.

GET/v1/technical-indicators

Technical indicators for a company.

GET/v1/insider-trades

Disclosed insider transactions.

GET/v1/short-positions

Disclosed short positions.

GET/v1/major-holdings

Major shareholding disclosures.

GET/v1/beneficial-owners

Beneficial ownership records.

GET/v1/corporate-ownership

Corporate ownership records.

GET/v1/instruments

Instrument reference data.

GET/v1/issuer-news

Issuer news and disclosures.

GET/v1/analyst-consensus

Analyst consensus records.

GET/v1/earnings-calendar

Earnings calendar records.

GET/v1/exchange-rates

Exchange rate data.

GET/v1/bond-yields

Bond yield series.

GET/v1/macro

Macroeconomic series.

GET/v1/freshness

Per-source recency and ingestion status.

Errors and pagination

Status	Meaning
`401`	Missing or invalid credentials.
`403`	Account or operation access denied.
`404`	Company or resource not found.
`422`	Query parameters failed validation.
`429`	Request or account limit reached; honor Retry-After.
`503`	Temporary service or authorization failure.

Use limit and offset where an endpoint supports them. Some statement responses include next_page_url: null; they do not offer a continuation page. Do not assume all datasets use the same pagination format.