Get Instrument Cash Flow Statements

v1.instrument_data.get_instrument_cash_flow_statements(, ) -> InstrumentDataGetInstrumentCashFlowStatementsResponse

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: str

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

minLength1

from_date: Optional[str]

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

page_size: Optional[int]

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

formatint64

maximum1000

minimum1

page_token: Optional[Union[str, Base64FileInput]]

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

formatbyte

to_date: Optional[str]

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

ReturnsExpand Collapse

class InstrumentDataGetInstrumentCashFlowStatementsResponse: …

data: InstrumentCashFlowStatementList

accepted_date: datetime

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

formatdate-time

filing_date: date

The date the financial statement was filed

formatdate

period: str

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

period_type: FiscalPeriodType

The type of fiscal period

One of the following:

"QUARTERLY"

"ANNUAL"

"TTM"

"BIANNUAL"

reported_currency: str

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

year: int

The fiscal year of the statement

formatint32

accounts_payables: Optional[str]

Change in accounts payables

accounts_receivables: Optional[str]

Change in accounts receivables

acquisitions_net: Optional[str]

Net acquisitions

capital_expenditure: Optional[str]

Capital expenditure

cash_at_beginning_of_period: Optional[str]

Cash and cash equivalents at beginning of period

cash_at_end_of_period: Optional[str]

Cash and cash equivalents at end of period

change_in_working_capital: Optional[str]

Change in working capital

common_dividends_paid: Optional[str]

Common dividends paid

common_stock_issuance: Optional[str]

Common stock issuance

common_stock_repurchased: Optional[str]

Common stock repurchased (buybacks)

deferred_income_tax: Optional[str]

Deferred income tax expense

depreciation_and_amortization: Optional[str]

Depreciation and amortization expense

effect_of_forex_changes_on_cash: Optional[str]

Effect of foreign exchange changes on cash

free_cash_flow: Optional[str]

Free cash flow (operating cash flow minus capital expenditure)

income_taxes_paid: Optional[str]

Income taxes paid

interest_paid: Optional[str]

Interest paid

inventory: Optional[str]

Change in inventory

investments_in_property_plant_and_equipment: Optional[str]

Investments in property, plant, and equipment

long_term_net_debt_issuance: Optional[str]

Long-term net debt issuance

net_cash_provided_by_financing_activities: Optional[str]

Net cash provided by financing activities

net_cash_provided_by_investing_activities: Optional[str]

Net cash provided by investing activities

net_cash_provided_by_operating_activities: Optional[str]

Net cash provided by operating activities

net_change_in_cash: Optional[str]

Net change in cash during the period

net_common_stock_issuance: Optional[str]

Net common stock issuance

net_debt_issuance: Optional[str]

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

net_dividends_paid: Optional[str]

Net dividends paid (common + preferred)

net_income: Optional[str]

Net income for the period

net_preferred_stock_issuance: Optional[str]

Net preferred stock issuance

net_stock_issuance: Optional[str]

Net stock issuance (common + preferred)

operating_cash_flow: Optional[str]

Operating cash flow (alternative calculation)

other_financing_activities: Optional[str]

Other financing activities

other_investing_activities: Optional[str]

Other investing activities

other_non_cash_items: Optional[str]

Other non-cash items

other_working_capital: Optional[str]

Change in other working capital

preferred_dividends_paid: Optional[str]

Preferred dividends paid

purchases_of_investments: Optional[str]

Purchases of investments

sales_maturities_of_investments: Optional[str]

Sales and maturities of investments

short_term_net_debt_issuance: Optional[str]

Short-term net debt issuance

stock_based_compensation: Optional[str]

Stock-based compensation expense

Get Instrument Cash Flow Statements

from clearstreet import ClearStreet

client = ClearStreet(
    api_key="My API Key",
)
response = client.v1.instrument_data.get_instrument_cash_flow_statements(
    instrument_id="x",
)
print(response)

{
  "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"
  }
}