# Get cash flow statements **API:** Data API **Endpoint:** `GET /v1/beta/financial/financials/cash-flow-statements` **Tags:** Financial Data Cash flow statements for one company, about 27 fields per period: `net_cash_flow_from_operations`, `net_cash_flow_from_investing`, `net_cash_flow_from_financing`, `capital_expenditure`, `depreciation_and_amortization`, `share_based_compensation`, `issuance_or_repayment_of_debt_securities`, `issuance_or_purchase_of_equity_shares` and `dividends_and_other_cash_distributions`, stamped with `report_period`, `fiscal_period` and `currency`. `period` is required. Use it to see cash generation rather than accounting earnings. Free cash flow yield and similar derived figures live in `get_financial_financial_metrics`. ### Pricing reference - Metering: Fixed successful-request cost basis. - Reference request estimate: USD 0.02. - Reference customer multiplier: 1.0. Do not apply it again to a settled customer amount. Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records. ## Base URL - `https://openapi.felo.ai` ## Authentication - `FeloBearerAuth` (http bearer, bearer format Felo API Key) - `FeloApiKey` (apiKey in header `X-API-Key`) ## Parameters | Name | In | Required | Type | Description | | --- | --- | --- | --- | --- | | `cik` | query | no | string | The Central Index Key (CIK) of the company. | | `cursor` | query | no | string | Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it. | | `filing_date` | query | no | string, (date) | Filter by exact SEC filing date in YYYY-MM-DD format. Rows without a known filing date are excluded. | | `filing_date_gt` | query | no | string, (date) | Filter by SEC filing date greater than date in YYYY-MM-DD format. Rows without a known filing date are excluded. | | `filing_date_gte` | query | no | string, (date) | Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format. Rows without a known filing date are excluded. | | `filing_date_lt` | query | no | string, (date) | Filter by SEC filing date less than date in YYYY-MM-DD format. Rows without a known filing date are excluded. | | `filing_date_lte` | query | no | string, (date) | Filter by SEC filing date less than or equal to date in YYYY-MM-DD format. Useful for point-in-time queries: returns only data that was publicly filed by the given date. Rows without a known filing date are excluded. | | `limit` | query | no | integer, (int32) | The maximum number of cash flow statements to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_url`. | | `period` | query | yes | string, enum: "annual", "quarterly", "ttm" | The time period of the cash flow statements. | | `report_period` | query | no | string, (date) | Filter by exact report period date in YYYY-MM-DD format. | | `report_period_gt` | query | no | string, (date) | Filter by report period greater than date in YYYY-MM-DD format. | | `report_period_gte` | query | no | string, (date) | Filter by report period greater than or equal to date in YYYY-MM-DD format. | | `report_period_lt` | query | no | string, (date) | Filter by report period less than date in YYYY-MM-DD format. | | `report_period_lte` | query | no | string, (date) | Filter by report period less than or equal to date in YYYY-MM-DD format. | | `ticker` | query | no | string | The ticker symbol. Required if cik is not provided. | ## Responses ### 200 — Cash flow statements response Headers: - `X-Request-Id` (string) — Request identifier to include when contacting Felo support. **application/json** Schema: `ResponseE40Feb4D3D6B_CashFlowStatementResponse` (`#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatementResponse`) ### 400 — The request could not be processed. Check the request parameters. ### 401 — A valid Felo API key is required. ### 402 — The request cannot proceed because a billing requirement is not met. ### 403 — The account is not permitted to perform this operation. ### 429 — A request or spending limit has been reached. ### 502 — The service could not complete the request. ### 503 — The API or billing service is temporarily unavailable. ### 504 — The service timed out while processing the request. ### default — Error response; upstream passthrough responses may use provider formats **application/json** Schema: ```json {} ``` ## Schema definitions ### ResponseE40Feb4D3D6B_CashFlowStatement `#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatement` ```json { "type": "object", "properties": { "ticker": { "type": "string", "description": "The ticker symbol." }, "report_period": { "type": "string", "format": "date", "description": "The reporting period of the cash flow statement." }, "fiscal_period": { "type": "string", "description": "The fiscal period of the cash flow statement." }, "period": { "type": "string", "enum": [ "quarterly", "ttm", "annual" ], "description": "The time period of the cash flow statement." }, "currency": { "type": "string", "description": "The currency in which the financial data is reported." }, "accession_number": { "type": [ "string", "null" ], "description": "The SEC accession number of the filing." }, "form_type": { "type": [ "string", "null" ], "description": "The SEC form this row was sourced from (`10-K`, `10-Q/A`, `20-F`, `S-1`, ...). The exact form as filed, so amendments keep their `/A` suffix. Null when `period` is `ttm`: a trailing twelve month window can span multiple filings, so we don't attribute it to one. A `quarterly` row can carry `10-K` when the fourth quarter is derived from the fiscal-year filing." }, "filing_url": { "type": [ "string", "null" ], "format": "uri", "description": "URL to the SEC filing." }, "filing_date": { "type": [ "string", "null" ], "format": "date", "description": "Calendar day SEC accepted the filing, in Eastern Time (the SEC's operating timezone). Calendar-day pair to `filing_datetime`. Null when no dated SEC filing is linked to the row." }, "filing_datetime": { "type": [ "string", "null" ], "format": "date-time", "description": "Sub-day timestamp recording when SEC accepted the filing, in Eastern Time. Sourced from SEC's `acceptanceDateTime` field on the EDGAR submissions API. Pairs with `filing_date` (calendar-day precision of the same event)." }, "net_income": { "type": "number", "description": "The net income of the company." }, "depreciation_and_amortization": { "type": "number", "description": "The depreciation and amortization of the company." }, "share_based_compensation": { "type": "number", "description": "The share-based compensation of the company." }, "net_cash_flow_from_operations": { "type": "number", "description": "The net cash flow from operations of the company." }, "capital_expenditure": { "type": "number", "description": "The capital expenditure of the company." }, "business_acquisitions_and_disposals": { "type": "number", "description": "The business acquisitions and disposals of the company." }, "investment_acquisitions_and_disposals": { "type": "number", "description": "The investment acquisitions and disposals of the company." }, "net_cash_flow_from_investing": { "type": "number", "description": "The net cash flow from investing of the company." }, "issuance_or_repayment_of_debt_securities": { "type": "number", "description": "The issuance or repayment of debt securities of the company." }, "issuance_or_purchase_of_equity_shares": { "type": "number", "description": "The issuance or purchase of equity shares of the company." }, "dividends_and_other_cash_distributions": { "type": "number", "description": "The dividends and other cash distributions of the company." }, "net_cash_flow_from_financing": { "type": "number", "description": "The net cash flow from financing of the company." }, "change_in_cash_and_equivalents": { "type": "number", "description": "The change in cash and equivalents of the company." }, "effect_of_exchange_rate_changes": { "type": "number", "description": "The effect of exchange rate changes of the company." }, "ending_cash_balance": { "type": "number", "description": "The ending cash balance of the company." }, "free_cash_flow": { "type": "number", "description": "The free cash flow of the company." } } } ``` ### ResponseE40Feb4D3D6B_CashFlowStatementResponse `#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatementResponse` ```json { "type": "object", "properties": { "cash_flow_statements": { "type": "array", "items": { "$ref": "#/components/schemas/ResponseE40Feb4D3D6B_CashFlowStatement" } }, "next_page_url": { "type": "string", "description": "Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records." } } } ```