All APIs

Cash flow statement API for company cash movements

Read operating, investing and financing cash flows as signed decimal strings, including negative outflows for acquisitions, interest paid and taxes paid.

First request

Quickstart →
curl --request GET \
  --url "https://api.narwhalapi.com/v1/companies/usa:0000789019/financials?statement=cash_flow" \
  --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",
      "operating_cash_flow": "182935000000",
      "capex": "-115948000000"
    }
  ]
}

Endpoints

GETGet standardised company financial statements/v1/companies/{company_id}/financials

Keep cash flow signs clear

Negative outflows

Cash leaving the company is recorded as a negative amount.

Acquisition payments

Acquisitions show cash paid net of cash acquired.

Taxes paid

Tax payments are net of refunds and recorded as negative outflows.

Coverage: US, Japan, Korea, EU/EEA, the UK and Taiwan; US history from 2009.

Response fields

operating_cash_flow
Net cash generated or used by operating activities.
investing_cash_flow
Net cash generated or used by investing activities.
financing_cash_flow
Net cash generated or used by financing activities.
capex
Cash spent to purchase property, plant and equipment, recorded as a negative outflow.
acquisitions
Cash paid for acquisitions, net of cash acquired, recorded as a negative outflow.
free_cash_flow
Always calculated as operating cash flow plus capital expenditure, with capital expenditure recorded as a negative cash outflow.
depreciation_amortization
Depreciation and amortization added back when reconciling profit to operating cash flow.
stock_based_compensation
Share-based compensation expense added back when reconciling profit to operating cash flow.
dividends_paid
Cash dividends paid, recorded as a negative outflow.
share_repurchases
Cash paid to repurchase the company's own shares, recorded as a negative outflow.
fx_effect_on_cash
The increase or decrease in cash caused by exchange rate changes.
interest_paid
Cash paid for interest, recorded as a negative outflow.
taxes_paid
Cash paid for taxes, net of refunds, recorded as a negative outflow.
net_change_in_cash
The net increase or decrease in cash, including the effect of exchange rate changes.

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 →

EPS API for earnings and dividends per share

Earnings, dividends and share counts for the primary common class

Explore the API →

Financial statements API for company analysis

Standardised statements, reporting periods and historical versions

Explore the API →

Common questions

Are interest payments negative?

Yes. interest_paid represents a cash outflow and carries a negative sign.

How does the acquisitions item handle acquired cash?

The acquisitions item subtracts cash acquired from cash paid for acquisitions and records the payment as a negative outflow.

Are cash flow amounts expressed in millions?

No scaling to millions is applied. Responses use decimal strings in the original filing currency.