{"uid":"cap_Rpgj7zxVDgSCm4G6uy7hS","slug":"financial-datasets-ai-cash-flow-statements-f3e595f7","name":"Financial Datasets AI — Cash Flow Statements","description":"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.","url":"https://api.financialdatasets.ai/financials/cash-flow-statements?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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 than or equal to date in YYYY-MM-DD format."},"report_period_lte":{"type":"string","description":"Filter by report period less than or equal to date in YYYY-MM-DD format."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yltnE82zunlzGb3K0EaQ3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"FCF trend analysis for valuation","prompt":"Get me Nvidia's quarterly free cash flow and capex from their SEC filings for the past 8 quarters so I can build a DCF model."},{"title":"Activist investor due diligence","prompt":"Pull the last three annual cash flow statements for Boeing — I need operating, investing, and financing cash flows plus capex as reported to the SEC."},{"title":"TTM cash flow snapshot for screener","prompt":"What's Microsoft's trailing twelve month operating cash flow and free cash flow right now, based on their most recent SEC filings?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T12:57:39.962Z","isFirstParty":false,"canonicalSlug":"financial-datasets-ai-cash-flow-statements-f3e595f7"}