Get Instrument Cash Flow Statements

$ clst v1:instrument-data get-instrument-cash-flow-statements

GET/v1/instruments/{instrument_id}/cash-flow-statements

Get cash flow statements for an instrument.

Retrieves historical cash flow statements for the specified instrument. Cash flow statements show cash inflows and outflows from operating, investing, and financing activities.

Pagination metadata does not include total_items or total_pages for this endpoint. Use next_page_token to detect whether more results exist.

ParametersExpand Collapse

--instrument-id: string

Instrument identifier: either an instrument UUID or a symbol (symbol for equities, OSI for options). Non-UUID inputs are resolved server-side.

--from-date: optional string

The start date for the query range, inclusive (YYYY-MM-DD).

--page-size: optional number

The number of items to return per page. Only used when page_token is not provided.

--page-token: optional string

Token for retrieving the next or previous page of results. Contains encoded pagination state; when provided, page_size is ignored.

--to-date: optional string

The end date for the query range, inclusive (YYYY-MM-DD).

ReturnsExpand Collapse

V1InstrumentDataGetInstrumentCashFlowStatementsResponse: BaseResponse { metadata, error }

data: array of InstrumentCashFlowStatement { accepted_date, filing_date, period, 42 more }

accepted_date: string

The date and time when the filing was accepted by the SEC

filing_date: string

The date the financial statement was filed

period: string

The fiscal period identifier (e.g., “Q1”, “Q2”, “Q3”, “Q4”)

period_type: "QUARTERLY" or "ANNUAL" or "TTM" or "BIANNUAL"

The type of fiscal period

"QUARTERLY"

"ANNUAL"

"TTM"

"BIANNUAL"

reported_currency: string

The currency in which the statement is reported (ISO 4217)

year: number

The fiscal year of the statement

accounts_payables: optional string

Change in accounts payables

accounts_receivables: optional string

Change in accounts receivables

acquisitions_net: optional string

Net acquisitions

capital_expenditure: optional string

Capital expenditure

cash_at_beginning_of_period: optional string

Cash and cash equivalents at beginning of period

cash_at_end_of_period: optional string

Cash and cash equivalents at end of period

change_in_working_capital: optional string

Change in working capital

common_dividends_paid: optional string

Common dividends paid

common_stock_issuance: optional string

Common stock issuance

common_stock_repurchased: optional string

Common stock repurchased (buybacks)

deferred_income_tax: optional string

Deferred income tax expense

depreciation_and_amortization: optional string

Depreciation and amortization expense

effect_of_forex_changes_on_cash: optional string

Effect of foreign exchange changes on cash

free_cash_flow: optional string

Free cash flow (operating cash flow minus capital expenditure)

income_taxes_paid: optional string

Income taxes paid

interest_paid: optional string

Interest paid

inventory: optional string

Change in inventory

investments_in_property_plant_and_equipment: optional string

Investments in property, plant, and equipment

long_term_net_debt_issuance: optional string

Long-term net debt issuance

net_cash_provided_by_financing_activities: optional string

Net cash provided by financing activities

net_cash_provided_by_investing_activities: optional string

Net cash provided by investing activities

net_cash_provided_by_operating_activities: optional string

Net cash provided by operating activities

net_change_in_cash: optional string

Net change in cash during the period

net_common_stock_issuance: optional string

Net common stock issuance

net_debt_issuance: optional string

Net debt issuance (long-term + short-term)

net_dividends_paid: optional string

Net dividends paid (common + preferred)

net_income: optional string

Net income for the period

net_preferred_stock_issuance: optional string

Net preferred stock issuance

net_stock_issuance: optional string

Net stock issuance (common + preferred)

operating_cash_flow: optional string

Operating cash flow (alternative calculation)

other_financing_activities: optional string

Other financing activities

other_investing_activities: optional string

Other investing activities

other_non_cash_items: optional string

Other non-cash items

other_working_capital: optional string

Change in other working capital

preferred_dividends_paid: optional string

Preferred dividends paid

purchases_of_investments: optional string

Purchases of investments

sales_maturities_of_investments: optional string

Sales and maturities of investments

short_term_net_debt_issuance: optional string

Short-term net debt issuance

stock_based_compensation: optional string

Stock-based compensation expense

Get Instrument Cash Flow Statements

clst v1:instrument-data get-instrument-cash-flow-statements \
  --api-key 'My API Key' \
  --instrument-id x

{
  "data": [
    {
      "accepted_date": "2025-05-02T14:30:00Z",
      "capital_expenditure": "-2600000000",
      "cash_at_beginning_of_period": "33743000000",
      "cash_at_end_of_period": "29943000000",
      "change_in_working_capital": "-3200000000",
      "common_stock_repurchased": "-23000000000",
      "depreciation_and_amortization": "2900000000",
      "filing_date": "2025-05-01",
      "free_cash_flow": "25800000000",
      "investments_in_property_plant_and_equipment": "-2600000000",
      "net_cash_provided_by_financing_activities": "-28300000000",
      "net_cash_provided_by_investing_activities": "-3900000000",
      "net_cash_provided_by_operating_activities": "28400000000",
      "net_change_in_cash": "-3800000000",
      "net_debt_issuance": "-1500000000",
      "net_dividends_paid": "-3800000000",
      "net_income": "22200000000",
      "operating_cash_flow": "28400000000",
      "period": "Q1",
      "period_type": "QUARTERLY",
      "purchases_of_investments": "-9500000000",
      "reported_currency": "USD",
      "sales_maturities_of_investments": "8200000000",
      "stock_based_compensation": "2500000000",
      "year": 2025
    }
  ],
  "error": null,
  "metadata": {
    "next_page_token": "AAAAAAAAAGQAAAAAAAAAZQ==",
    "page_number": 1,
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

{
  "error": {
    "code": 404,
    "message": "Instrument not found: AAPL"
  },
  "metadata": {
    "request_id": "fa8cc9b2-fbf0-4f5b-8ce3-b3205b9f85f2"
  }
}

Returns Examples

{
  "data": [
    {
      "accepted_date": "2025-05-02T14:30:00Z",
      "capital_expenditure": "-2600000000",
      "cash_at_beginning_of_period": "33743000000",
      "cash_at_end_of_period": "29943000000",
      "change_in_working_capital": "-3200000000",
      "common_stock_repurchased": "-23000000000",
      "depreciation_and_amortization": "2900000000",
      "filing_date": "2025-05-01",
      "free_cash_flow": "25800000000",
      "investments_in_property_plant_and_equipment": "-2600000000",
      "net_cash_provided_by_financing_activities": "-28300000000",
      "net_cash_provided_by_investing_activities": "-3900000000",
      "net_cash_provided_by_operating_activities": "28400000000",
      "net_change_in_cash": "-3800000000",
      "net_debt_issuance": "-1500000000",
      "net_dividends_paid": "-3800000000",
      "net_income": "22200000000",
      "operating_cash_flow": "28400000000",
      "period": "Q1",
      "period_type": "QUARTERLY",
      "purchases_of_investments": "-9500000000",
      "reported_currency": "USD",
      "sales_maturities_of_investments": "8200000000",
      "stock_based_compensation": "2500000000",
      "year": 2025
    }
  ],
  "error": null,
  "metadata": {
    "next_page_token": "AAAAAAAAAGQAAAAAAAAAZQ==",
    "page_number": 1,
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

{
  "error": {
    "code": 404,
    "message": "Instrument not found: AAPL"
  },
  "metadata": {
    "request_id": "fa8cc9b2-fbf0-4f5b-8ce3-b3205b9f85f2"
  }
}