# Financial Datasets AI — Cash Flow Statements

> Financial Datasets AI — Cash Flow Statements is a paid API for AI agents from api.financialdatasets.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-31).

Retrieves standardized cash flow statements (operating, investing, financing, capex, free cash flow) for a US-listed company from SEC filings, by ticker or CIK, for annual, quarterly, or TTM periods.

## Facts

- Endpoint: GET https://api.financialdatasets.ai/financials/cash-flow-statements?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-31
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/financial-datasets-ai-cash-flow-statements-f3e595f7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Rpgj7zxVDgSCm4G6uy7hS

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability financial-datasets-ai-cash-flow-statements-f3e595f7
```

Example prompt: Pull Apple's annual cash flow statements from SEC filings for the last 5 years — I need operating cash flow, capex, and free cash flow for each year.

## When to prefer this

Use this endpoint when you need standardized, SEC-sourced cash flow data (operating, investing, financing cash flows, capex, or free cash flow) for a US-listed public company. Prefer it over income statement or balance sheet endpoints when cash generation, capital spending, or liquidity analysis is the goal. It supports annual, quarterly, and TTM aggregation with flexible date filtering, making it ideal for valuation models, financial screening, and fundamental research. Use sibling endpoints for revenue/earnings (income statement), asset/liability data (balance sheet), or real-time price/metrics snapshots.

## Known failure modes

- Invalid or unknown ticker/CIK returns empty results or 404
- Missing required 'period' parameter returns 400 validation error
- Filing date or report period filters with no matching data return empty list
- Non-Professional use accessing data beyond plan limits may return 402/403
- Malformed date strings (not YYYY-MM-DD) cause parameter rejection
- TTM period unavailable for very recently listed companies

## How this service works

Cash flow statements for a company by ticker or CIK, standardized from SEC filings: operating, investing and financing cash flows, capital expenditure, free cash flow and their main line items. Period annual, quarterly or ttm; filter by report_period or filing_date. Use when an agent needs operating cash flow, capex or free cash flow as reported. Non-Professional use; Professional use needs a plan at financialdatasets.ai.

## Output

Returns a paginated list of standardized cash flow statement objects for the specified company and period, each containing: operating cash flow, investing cash flow, financing cash flow, capital expenditure, free cash flow, and their main constituent line items, along with the report period date, filing date, ticker, CIK, and a next_page_url cursor for pagination.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "period"
     ],
     "properties": {
      "cik": {
       "type": "string",
       "description": "The Central Index Key (CIK) of the company."
      },
      "limit": {
       "type": "integer",
       "description": "The maximum number of cash flow statements to return."
      },
      "cursor": {
       "type": "string",
       "description": "Opaque pagination cursor from a previous response's next_page_url."
      },
      "period": {
       "enum": [
        "annual",
        "quarterly",
        "ttm"
       ],
       "type": "string",
       "description": "The time period of the cash flow statements."
      },
      "ticker": {
       "type": "string",
       "description": "The ticker symbol."
      },
      "filing_date": {
       "type": "string",
       "description": "Filter by exact SEC filing date in YYYY-MM-DD format."
      },
      "report_period": {
       "type": "string",
       "description": "Filter by exact report period date in YYYY-MM-DD format."
      },
      "filing_date_gt": {
       "type": "string",
       "description": "Filter by SEC filing date greater than date in YYYY-MM-DD format."
      },
      "filing_date_lt": {
       "type": "string",
       "description": "Filter by SEC filing date less than date in YYYY-MM-DD format."
      },
      "filing_date_gte": {
       "type": "string",
       "description": "Filter by SEC filing date greater than or equal to date in YYYY-MM-DD format."
      },
      "filing_date_lte": {
       "type": "string",
       "description": "Filter by SEC filing date less than or equal to date in YYYY-MM-DD format."
      },
      "report_period_gt": {
       "type": "string",
       "description": "Filter by report period greater than date in YYYY-MM-DD format."
      },
      "report_period_lt": {
       "type": "string",
       "description": "Filter by report period less than date in YYYY-MM-DD format."
      },
      "report_period_gte": {
       "type": "string",
       "description": "Filter by report period greater tha
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/financial-datasets-ai-cash-flow-statements-f3e595f7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.financialdatasets.ai](https://www.zero.xyz/host/api.financialdatasets.ai/llms.txt)