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, provenance fields, and per-figure page_id (when available via content search).

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",
          "source": "esef",
          "source_url": "https://filings.xbrl.org/…",
          "concept": "ifrs-full:Revenue",
          "filing_index": "743700UJPK…"
        }
      }
    }
  ]
}

Provenance fields

Each metric object may include provenance fields when available:

Field	Description
`source`	Data source: `"esef"`, `"avainluvut"`, `"sec_xbrl"`, etc.
`source_url`	Link to the original filing viewer or document.
`concept`	IFRS or US-GAAP XBRL concept tag (e.g. `"ifrs-full:Revenue"`).
`filing_index`	Filing identifier (LEI-based for ESEF, accession number for SEC).

These fields are null when the source does not provide structured provenance (e.g. some PDF-extracted data).

Period types

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