{"uid":"cap_cpNhUCj73eI28hEFRTw2z","slug":"stablefinance-cash-flow-statements-segments-8e2a8855","name":"StableFinance Cash Flow Statements Segments","description":"Cash flow segment breakdowns.","url":"https://stablefinance.dev/api/financials/cash-flow-statements/segments","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","$schema":"https://json-schema.org/draft/2020-12/schema","required":["period"],"properties":{"cik":{"type":"string","minLength":1},"limit":{"type":"integer","maximum":50,"minimum":1},"period":{"enum":["annual","quarterly"],"type":"string"},"ticker":{"type":"string","minLength":1},"report_period":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_gt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_lt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_gte":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_lte":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["segmented_financials"],"properties":{"segmented_financials":{"type":"array","items":{}}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"segmented_financials":[{"period":"annual","ticker":"AAPL","revenue":{"product":[{"label":"iPhone","value":201183000000},{"label":"Mac","value":29984000000},{"label":"Services","value":96169000000}]},"report_period":"2024-09-28"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_GuRpvyidVv1Bz3EglMryM","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 segmented cash flow statement data for public companies, broken down by business segment (e.g. product lines, geographies), for a given period.","exampleAgentPrompt":"Pull the annual segmented cash flow statement data for Apple (AAPL) from Financial Datasets AI — I want to see the revenue breakdown by product segment for the most recent report, limit to 5 results.","exampleUseCases":null,"resultDescription":"Returns an array of segmented financial records, each containing the company ticker, reporting period date, period type (annual/quarterly), and nested revenue breakdowns by named business segment (e.g. iPhone, Mac, Services) with their corresponding dollar values.","failureModes":["Missing required 'period' parameter returns a 400 validation error","Invalid ticker symbol returns empty segmented_financials array","CIK or ticker not found in database returns empty results","Date filter pattern mismatch (not YYYY-MM-DD) causes schema validation error","Limit exceeds maximum of 50 returns a validation error","Payment of $0.02 USDC not fulfilled results in 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need business-segment-level granularity within cash flow statements — not just top-line totals — for a specific public company identified by ticker or CIK. Prefer this over general income statement endpoints when the user wants to understand revenue by product line, geography, or division. Best for fundamental equity research, competitive benchmarking by segment, or tracking how individual product lines trend over time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:34:17.727Z","isFirstParty":false}