API · Companies

Get a full financial statement

Line-item income statement, balance sheet, or cash flow with per-period metric labels.

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

Returns up to 25 periods of a complete financial statement — income statement, balance sheet, or cash flow — with metric names, values, units, and per-figure pdf_info.page_id (when available).

When to use this

Building a multi-year trend chart of operating margin.
Rendering a full income statement table on a company page.
Feeding a forecasting model that needs every reported line.

For headline KPIs only, use the financials endpoint — it is cheaper and pre-aggregated.

Path

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

Query

Field	Type	Description
statement	string default: income_statement	income_statement \| balance_sheet \| cash_flow
years	integer default: 10	Max periods to return (1–25).
market	string	nordic \| us. Omit to auto-detect.
period_type	string default: annual	annual \| quarterly \| auto
year	integer	Filter to a specific fiscal year.
quarter	integer	Filter to a specific quarter (1–4).

Example

bash

curl "https://api.clarifo.com/api/v1/data/companies/Fiskars/statement?statement=income_statement&years=10" \
  -H "Authorization: Bearer $CLARIFO_API_KEY"

Response

json

{
  "company_name": "Fiskars",
  "market": "nordic",
  "statement": "income_statement",
  "period_type": "annual",
  "periods": [
    {
      "year": 2024,
      "quarter": null,
      "period": "2024",
      "metrics": {
        "revenue": {
          "metric_name": "Liikevaihto",
          "value": 1250.5,
          "unit": "MEUR",
          "currency": "EUR"
        }
      }
    }
  ]
}

Period types

`period_type`	Returns
`annual` (default)	Newest fiscal years.
`quarterly`	Newest quarters.
`auto`	Annual + quarterly rows mixed, newest first.