All APIs

Financial statements API for company analysis

Get standardised financial statements in annual and quarterly periods, with semiannual reports where available and history and delivery timing set by plan.

First request

Quickstart →
curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"
Example response Illustrative response · not a live request
{
  "id": "usa:0000789019",
  "currency": "USD",
  "annual": [
    {
      "fy": 2026,
      "end": "2026-06-30",
      "revenue": "331839000000",
      "net_income": "133749000000",
      "total_assets": "758376000000",
      "operating_cash_flow": "182935000000",
      "eps_diluted": "17.95"
    }
  ]
}

Endpoints

GETGet standardised company financial statements/v1/companies/{company_id}/financials
GETGet financials as reported in a filing/v1/filings/{filing_id}/financials/as-reported

History and timing by plan

Free

The last 3 years of annual figures, delivered the next day.

Basic

10 years of history, with quarters delivered live.

Pro

Full history, plus first-reported figures and as-of queries for the numbers known on a past date.

Coverage

View coverage →

Coverage: annual and quarterly for US, Korea and Taiwan; annual and semiannual for Japan only; annual only for EU/EEA and the UK. US history from 2009.

Response fields

fy
Fiscal year associated with the reporting period
fq
Fiscal quarter, when applicable
fh
Fiscal half-year, when applicable
end
End date of the reporting period
derived
Marks figures calculated from reported values
currency
Currency used in the filing, without conversion

Explore related pages

Income statement API for company earnings

Revenue, costs and profit from company filings

Explore the API →

Balance sheet API for company financial position

Assets, liabilities, equity and derived balance sheet items

Explore the API →

Cash flow statement API for company cash movements

Operating, investing and financing cash flows with signed outflows

Explore the API →

EPS API for earnings and dividends per share

Earnings, dividends and share counts for the primary common class

Explore the API →

Common questions

Are all 77 standard items available on Free?

All 77 standard items are on every plan. A response omits any item missing from the filing.

What do first-reported figures and as-of queries mean?

First-reported figures preserve numbers as first filed, before restatements. As-of queries return the numbers known on a past date. Both are available on Pro.

Can one series mix consolidated and standalone statements?

No. Narwhal uses consolidated figures when available and never mixes consolidated and standalone figures within one series. Derived items are marked.