This endpoint replaces Financials.
Cash Flow Statements
GET
/stocks/financials/v1/cash-flow-statements
Retrieve comprehensive cash flow statement data for public companies, including quarterly, annual, and trailing twelve-month cash flows. This dataset includes detailed operating, investing, and financing cash flows with TTM calculations that sum all cash flow components over four quarters.
Use Cases: Cash flow analysis, liquidity assessment, operational efficiency evaluation, investment activity tracking.
Plan AccessIncluded in select Stocks plans
Plan
Recency
Not included
Not included
Not included
End-of-day
End-of-day
End-of-day
End-of-day
Plan RecencyEnd-of-day (updated daily)
Plan
History
Not included
Not included
Not included
All history
All history
All history
All history
Plan HistoryRecords date back to March 29, 2009
Query Parameters
cik
string
The company's Central Index Key (CIK), a unique identifier assigned by the U.S. Securities and Exchange Commission (SEC). You can look up a company’s CIK using the SEC CIK Lookup tool.
period_end
string
The last date of the reporting period (formatted as YYYY-MM-DD). Value must be formatted 'yyyy-mm-dd'.
tickers
string
Filter for arrays that contain the value.
fiscal_year
number
The fiscal year for the reporting period. Value must be a floating point number.
fiscal_quarter
number
The fiscal quarter number (1, 2, 3, or 4) for the reporting period. Value must be a floating point number.
timeframe
string
The reporting period type. Possible values include: quarterly, annual, trailing_twelve_months.
limit
integer
Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '50000'.
sort
string
A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'period_end' if not specified. The sort order defaults to 'desc' if not specified.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page.
request_id
string
A request id assigned by the server.
results
array (object)
The results for this request.
cash_from_operating_activities_continuing_operations
number
optional
Cash generated from continuing business operations before discontinued operations.
change_in_cash_and_equivalents
number
optional
Net change in cash and cash equivalents during the period, representing the sum of operating, investing, and financing cash flows plus currency effects.
change_in_other_operating_assets_and_liabilities_net
number
optional
Net change in working capital components including accounts receivable, inventory, accounts payable, and other operating items.
cik
string
optional
The company's Central Index Key (CIK), a unique identifier assigned by the U.S. Securities and Exchange Commission (SEC). You can look up a company’s CIK using the SEC CIK Lookup tool.
depreciation_depletion_and_amortization
number
optional
Non-cash charges for the reduction in value of tangible and intangible assets over time.
dividends
number
optional
Cash payments to shareholders in the form of dividends, typically reported as negative values.
effect_of_currency_exchange_rate
number
optional
Impact of foreign exchange rate changes on cash and cash equivalents denominated in foreign currencies.
fiscal_quarter
number
optional
The fiscal quarter number (1, 2, 3, or 4) for the reporting period.
fiscal_year
number
optional
The fiscal year for the reporting period.
income_loss_from_discontinued_operations
number
optional
After-tax income or loss from business operations that have been discontinued.
long_term_debt_issuances_repayments
number
optional
Net cash flows from issuing or repaying long-term debt obligations.
net_cash_from_financing_activities
number
optional
Total cash generated or used by financing activities, including debt issuance, debt repayment, dividends, and share transactions.
net_cash_from_financing_activities_continuing_operations
number
optional
Cash flows from financing activities of continuing operations before discontinued operations.
net_cash_from_financing_activities_discontinued_operations
number
optional
Cash flows from financing activities of discontinued business segments.
net_cash_from_investing_activities
number
optional
Total cash generated or used by investing activities, including capital expenditures, acquisitions, and asset sales.
net_cash_from_investing_activities_continuing_operations
number
optional
Cash flows from investing activities of continuing operations before discontinued operations.
net_cash_from_investing_activities_discontinued_operations
number
optional
Cash flows from investing activities of discontinued business segments.
net_cash_from_operating_activities
number
optional
Total cash generated or used by operating activities, representing cash flow from core business operations.
net_cash_from_operating_activities_discontinued_operations
number
optional
Cash flows from operating activities of discontinued business segments.
net_income
number
optional
Net income used as the starting point for operating cash flow calculations.
noncontrolling_interests
number
optional
Cash flows related to minority shareholders in consolidated subsidiaries.
other_cash_adjustments
number
optional
Other miscellaneous adjustments to cash flows not classified elsewhere.
other_financing_activities
number
optional
Cash flows from financing activities not classified elsewhere, including share repurchases and other equity transactions.
other_investing_activities
number
optional
Cash flows from investing activities not classified elsewhere, including acquisitions, divestitures, and investments.
other_operating_activities
number
optional
Other adjustments to reconcile net income to operating cash flow not classified elsewhere.
period_end
string
optional
The last date of the reporting period (formatted as YYYY-MM-DD).
purchase_of_property_plant_and_equipment
number
optional
Cash outflows for capital expenditures on fixed assets, typically reported as negative values.
sale_of_property_plant_and_equipment
number
optional
Cash inflows from disposing of fixed assets, typically reported as positive values.
short_term_debt_issuances_repayments
number
optional
Net cash flows from issuing or repaying short-term debt obligations.
tickers
array (string)
optional
A list of ticker symbols under which the company is listed. Multiple symbols may indicate different share classes for the same company.
timeframe
string
optional
The reporting period type. Possible values include: quarterly, annual, trailing_twelve_months.
status
enum (OK)
The status of this request's response.
Code Examples
Query URL
GET
Run query unavailable
Create account or sign in to Polygon
Scroll to see updated query response
Response Object