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",
  "ticker": "NESTE",
  "exchange": "OMXH",
  "by_year": {
    "2024": {
      "revenue": 21990000000,
      "gross_profit": 3200000000,
      "operating_income": 1850000000,
      "EBIT": 1850000000,
      "EBITDA": 2400000000,
      "net_income": 640000000,
      "eps_diluted": 0.83,
      "total_assets": 18500000000,
      "total_equity": 9200000000,
      "current_assets": 7100000000,
      "non_current_assets": 11400000000,
      "operating_cash_flow": 2100000000,
      "capital_expenditures": 800000000,
      "free_cash_flow": 1300000000,
      "revenue_growth": -0.02,
      "ebitda_margin": 0.109,
      "operating_margin": 0.084,
      "net_profit_margin": 0.029,
      "equity_ratio": 0.497
    },
    "2023": { "revenue": 22458000000, "…": "…" }
  },
  "latest_period": {
    "period_label": "Q3/2025",
    "period_type": "quarterly",
    "year": 2025,
    "quarter": 3,
    "period_start": "2025-07-01",
    "period_end": "2025-09-30",
    "source": "eu_avainluvut_q",
    "metrics": {
      "revenue": {"value": 5800000000, "unit": "EUR", "source": "eu_avainluvut_q"}
    }
  },
  "data_quality_warnings": []
}

`by_year` fields

Each year object contains up to 20 typed core metrics. Additional market-specific metrics may appear as extra keys.

Category	Fields
Income statement	`revenue`, `gross_profit`, `operating_income`, `EBIT`, `EBITDA`, `net_income`, `eps_diluted`
Balance sheet	`total_assets`, `total_equity`, `current_assets`, `non_current_assets`
Cash flow	`operating_cash_flow`, `capital_expenditures`, `free_cash_flow`
Margins and ratios	`revenue_growth`, `ebitda_margin`, `operating_margin`, `net_profit_margin`, `equity_ratio`
US only	`period_end` (fiscal period end date)

All fields are nullable -- a null value means the metric is not available for that year.

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.