FocusAlphaDocs
Get key
API Reference

Cash-Flow Statements

A company's cash-flow statement as clean, normalized numbers — operating, investing, and financing flows plus free cash flow — derived deterministically from the SEC XBRL data companies file. Annual, quarterly, or trailing-twelve-month, with the source accession and filing URL on every row.

GET/v1/financials/cash-flow-statements

Provide a ticker or cik and a period. Each row covers one reporting period, newest first, and carries the source accession and filing URL.

Coverage & freshness
We cover ~2,000 US-listed companies — the entire S&P 500 plus roughly 1,500 more US mid- and small-caps — with numbers derived from SEC filings and kept current within about a day of a new 10-K or 10-Q. See Coverage & data source for the full list and the IFRS boundary.

Query parameters#

tickerstringoptional
US ticker, e.g. AAPL. Provide ticker or cik (at least one is required).
cikstringoptional
SEC Central Index Key — an alternative to ticker.
period"annual" | "quarterly" | "ttm"required
Reporting period (required). annual = 10-K periods, quarterly = 10-Q periods, ttm = trailing twelve months.
limitnumberoptional
Number of reporting periods to return, newest first. Defaults to 4.
report_periodstringoptional
Return only the period whose report date equals this exact date (YYYY-MM-DD, the fiscal period end). Combine with the range filters as an additional AND constraint.
report_period_gtestringoptional
Only periods with a report date on or after this date (YYYY-MM-DD). Also available: report_period_lte, report_period_gt, report_period_lt.

Example request#

curlbash
curl "https://api.focusalpha.ai/v1/financials/cash-flow-statements?ticker=AAPL&period=annual&limit=4" \
  -H "Authorization: Bearer $FOCUSALPHA_API_KEY"

Response#

Returns a cash_flow_statements array, newest first. Each row carries the shared identifying fields, then the cash-flow line items.

Shared row fields#

Every statement row carries the same identifying fields, then its line items.

tickerstringrequired
Company ticker.
ciknumberrequired
SEC Central Index Key.
report_periodstringrequired
The fiscal period end date (YYYY-MM-DD).
periodstringrequired
The requested period — annual, quarterly, or ttm.
fiscal_periodstring | nulloptional
The fiscal label — FY, Q1, Q2, or Q3.
currencystringrequired
Reporting currency, e.g. USD.
accession_numberstring | nulloptional
The SEC filing these numbers were derived from.
filing_urlstring | nulloptional
Link to the source filing on EDGAR.
calendar_datestring | nulloptional
Calendar-aligned period date, where available.

Cash-flow line items#

Fields: net_income, depreciation_and_amortization, share_based_compensation, net_cash_flow_from_operations, capital_expenditure, business_acquisitions_and_disposals, investment_acquisitions_and_disposals, net_cash_flow_from_investing, issuance_or_repayment_of_debt_securities, issuance_or_purchase_of_equity_shares, dividends_and_other_cash_distributions, net_cash_flow_from_financing, change_in_cash_and_equivalents, effect_of_exchange_rate_changes, ending_cash_balance, free_cash_flow. The period change in cash is change_in_cash_and_equivalents.

Example response#

cash-flow-statements.jsonjson
{
  "cash_flow_statements": [
    {
      "ticker": "AAPL",
      "cik": 320193,
      "report_period": "2024-09-28",
      "period": "annual",
      "fiscal_period": "FY",
      "currency": "USD",
      "accession_number": "0000320193-24-000123",
      "filing_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123",
      "net_income": 93736000000,
      "depreciation_and_amortization": 11445000000,
      "net_cash_flow_from_operations": 118254000000,
      "capital_expenditure": 9447000000,
      "net_cash_flow_from_investing": 2935000000,
      "net_cash_flow_from_financing": -121983000000,
      "change_in_cash_and_equivalents": -794000000,
      "free_cash_flow": 108807000000
    }
  ]
}
Numbers, as filed
Values are pulled from each company’s XBRL facts — public-domain structured data filed with the SEC — and normalized to a consistent schema. They are not adjusted, restated, or estimated.
Need all three statements?
The combined /v1/financials route returns income statements, balance sheets, and cash-flow statements in a single call.

Errors#

Statuses: 400 (missing both ticker and cik, a missing or invalid period, or a bad limit / date), 401 (bad or missing API key), 402 (per-minute rate limit or monthly quota exceeded — upgrade your plan), 404 (unresolvable ticker or CIK), 503 with a Retry-After header (data temporarily unavailable — retry shortly), and 500. A known company with no US-GAAP data is a successful 200 with empty arrays, not an error. See Errors.