API · Companies

Get key financial figures

Revenue, EBITDA, EBIT, net income, EPS, equity, cash flow — annual + latest period.

GET/api/v1/data/companies/{company}/financials

Returns a compact KPI summary for a company: annual revenue, gross profit, operating income, EBIT, EBITDA, net income, EPS, total assets, equity, equity ratio, operating + free cash flow, and per-period margins. The response also includes a latest_period block that surfaces the freshest disclosure — annual or quarterly, whichever ended most recently.

When to use this

Headline KPIs on a company card.
Driving a "latest revenue" tile that updates the moment a Q3 release lands.
Smoke-testing whether Clarifo has any data for a given ticker.

For line-item detail, use the statement endpoint.

Path

Field	Type	Description
companyrequired	string	Name, ticker, or ISIN.

Query

Field	Type	Description
years	integer default: 5	Annual periods in by_year (1–10).
market	string	nordic \| us. Omit to auto-detect.
period_type	string default: auto	auto \| annual \| quarterly — selects latest_period.
year	integer	Pin latest_period to a specific fiscal year.
quarter	integer	Pin latest_period to a quarter (1–4).

Example

curl

curl "https://api.clarifo.com/api/v1/data/companies/Neste/financials?years=5" \
  -H "Authorization: Bearer $CLARIFO_API_KEY"

Response

json

{
  "company_name": "Neste Oyj",
  "display_name": "Neste Oyj",
  "market": "nordic",
  "by_year": {
    "2024": {"revenue": 21990000000, "operating_income": 1850000000, …},
    "2023": { … }
  },
  "latest_period": {
    "period_label": "Q3/2025",
    "period_type": "quarterly",
    "year": 2025,
    "quarter": 3,
    "period_end": "2025-09-30",
    "source": "eu_avainluvut_q",
    "metrics": {
      "revenue": {"value": 5800000000, "unit": "EUR", "source": "eu_avainluvut_q"}
    }
  }
}

Period selection rules

`period_type`	Selection
`auto` (default)	The single newest period across annual and quarterly.
`annual`	The newest fiscal year.
`quarterly`	The newest quarter.