Financials

Cash flow statement

GET/api/v2/cash-flow-statements

Coverage: US / CN / JP, the last 3 years
Billing: 20 cr / thousand calls

Cash flow statement, one row per period, with 16 line-item columns plus the 12 common fields from the section preamble. Signs follow the statement direction: outflows such as capital expenditures, share repurchases and dividends are negative, inflows such as proceeds from the disposal of investments are positive. free_cash_flow is a derived column (not an as-reported line); the remaining columns are line-item values on an as-reported basis.

The example shows only a selection of the line-item columns; the field table is authoritative for the full key set.

Shared financials conventions

US / CN / JP, the last 3 years; markets out of scope return 404 . The three statement endpoints take the same parameters (ticker / period / limit) and return one row per period, aligned on (ticker, fiscal_year, period); for each ticker they return the most recent limit periods in descending report_period order. Valuation and derived financial metrics are provided separately by /financial-metrics-snapshot.

period: FY (default) / Q1–Q4 / H1. Accepts multiple comma-separated values. Periods actually disclosed per market: US FY Q1–Q3 (no standalone Q4 single-quarter figure), CN FY Q1 H1 Q3, JP FY H1 (no quarterly reports); a period that does not exist returns an empty array (Q4 is currently not disclosed separately in any of the three markets and is always an empty array; the caller computes fourth-quarter flow figures itself: US = FY − Q1 − Q2 − Q3, CN = FY − Q3 (Q3 is year-to-date cumulative), and JP has no quarterly figures; /balance-sheets holds point-in-time values, so no such subtraction applies). There is no date filter; limit counts back from the most recent period.

Common fields (present on every row of all three statements):

Field	Type	Description
`ticker`	string	Canonical ticker (US has no suffix, e.g. `AAPL`; CN is `600519.SH`; JP is `7203.T`)
`market`	string	Market code: `US` / `CN` / `JP`
`fiscal_year`	int	Fiscal year
`period`	string	`FY` / `Q1`–`Q4` / `H1`
`period_start`	date	Period start date; null for `/balance-sheets`
`report_period`	date	Period end date
`currency`	string	Reporting currency
`accounting_standard`	string	`US-GAAP` / `IFRS` / `CN-GAAP` / `JP-GAAP`
`accession_number`	string	Native document number from the official source: US is the SEC accession (e.g. `0000320193-25-000123`), JP the EDINET docID, CN the cninfo announcement id
`form_type`	string	Type of the source filing, in the market's native encoding (US: SEC form names such as `10-K` / `10-Q`; JP: EDINET numeric codes; CN: `annual_report` and the like)
`filing_url`	string	Deep link to the official filing; opens the source document directly
`filing_date`	date	Filing date: the date the document became public on the official channel

Value conventions (common to all three statements):

Field names are cross-market canonical line-item names; values are numbers in the base unit of currency; line items that do not apply are null.
Cash outflows are negative, inflows positive.
Flow line items are as reported, no de-cumulation is applied, and the value corresponds to the [period_start, report_period] range: US quarterly reports carry single-quarter figures; the CN third-quarter report (Q3) is year-to-date cumulative, the single-quarter figure = Q3 − H1 and the fourth quarter = FY − Q3; the semi-annual report (H1) is cumulative for the first half.
For derived line items (ebitda / total_debt / net_debt / free_cash_flow), missing components count as 0; the value is null only when all components are missing.
Only GAAP / statutory-basis figures are returned; for non-GAAP numbers, use /filing-search.

Query parameters

Parameter	Type	Required	Description
ticker	string	required	Up to 10 tickers, comma-separated.
period	string	optional	FY / Q1–Q4 / H1; multiple values allowed, comma-separated; see the head of this section for which periods each market has. Default FY.
limit	int	optional	Number of periods per ticker, counting back from the most recent period; maximum 40. Default 4.

Response fields

Field	Type	Description
ticker	string	Canonical ticker (US has no suffix, e.g. AAPL; CN is 600519.SH; JP is 7203.T)
market	string	Market code: US / CN / JP
fiscal_year	int	Fiscal year
period	string	FY / Q1–Q4 / H1
period_start	date	Period start date; null for /balance-sheets
report_period	date	Period end date
currency	string	Reporting currency
accounting_standard	string	US-GAAP / IFRS / CN-GAAP / JP-GAAP
accession_number	string	Native document number from the official source: US is the SEC accession (e.g. 0000320193-25-000123), JP the EDINET docID, CN the cninfo announcement id
form_type	string	Type of the source filing, in the market's native encoding (US: SEC form names such as 10-K / 10-Q; JP: EDINET numeric codes; CN: annual_report and the like)
filing_url	string	Deep link to the official filing; opens the source document directly
filing_date	date	Filing date: the date the document became public on the official channel
operating_cash_flow	number	Net cash flow from operating activities
change_in_working_capital	number	Change in working capital
capital_expenditures	number	Capital expenditures (negative)
acquisitions_net	number	Net cash paid for acquisitions (negative)
purchases_of_investments	number	Cash paid for investments (negative)
proceeds_from_investments	number	Cash received from disposal of investments (positive)
investing_cash_flow	number	Net cash flow from investing activities
share_repurchases	number	Cash paid for share repurchases (negative)
dividends_paid	number	Dividends paid (negative, including those paid to noncontrolling interests). The CN statutory line "Cash paid for distribution of dividends or profits, or for interest payments" includes interest, and is returned exactly as filed, not split out
financing_cash_flow	number	Net cash flow from financing activities
effect_of_exchange_rate_on_cash	number	Effect of exchange rate changes on cash
net_change_in_cash	number	Net change in cash
cash_at_end_of_period	number	Cash at end of period
income_taxes_paid	number	Supplemental disclosure: income taxes paid (negative)
interest_paid	number	Supplemental disclosure: interest paid (negative)
free_cash_flow	number	Derived (not an as-reported line) = operating_cash_flow + capital_expenditures

Request

curl -H "X-API-KEY: $DRILLR_API_KEY" \
  "https://gateway.drillr.ai/api/v2/cash-flow-statements?ticker=AAPL&period=FY&limit=3"

Response · 200

{
  "data": [
    {
      "ticker": "AAPL",
      "market": "US",
      "fiscal_year": 2025,
      "period": "FY",
      "period_start": "2024-09-29",
      "report_period": "2025-09-27",
      "currency": "USD",
      "accounting_standard": "US-GAAP",
      "operating_cash_flow": 111482000000,
      "capital_expenditures": -12715000000,
      "investing_cash_flow": 15195000000,
      "share_repurchases": -90711000000,
      "dividends_paid": -15421000000,
      "financing_cash_flow": -120686000000,
      "net_change_in_cash": 5991000000,
      "cash_at_end_of_period": 35934000000,
      "income_taxes_paid": -43369000000,
      "interest_paid": null,
      "free_cash_flow": 98767000000,
      "accession_number": "0000320193-25-000079",
      "form_type": "10-K",
      "filing_date": "2025-10-31",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/..."
    }
  ]
}

No key yet? Create one under API Keys — it is shown once, so store it where your shell can read it. Connecting an agent over MCP instead? That signs in through the browser and needs no key at all.

Authentication, conventions, rate limits and error shapes are the same for every endpoint — they live on REST API.