# StableFinance Cash Flow Statements Segments

> StableFinance Cash Flow Statements Segments is a paid API for AI agents from stablefinance.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-15).

Retrieves segmented cash flow statement data for public companies, broken down by business segment (e.g. product lines, geographies), for a given period.

## Facts

- Endpoint: GET https://stablefinance.dev/api/financials/cash-flow-statements/segments
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablefinance-cash-flow-statements-segments-8e2a8855
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cpNhUCj73eI28hEFRTw2z

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 stablefinance-cash-flow-statements-segments-8e2a8855
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Cash flow segment breakdowns.

## Output

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.

## 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",
     "$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
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablefinance-cash-flow-statements-segments-8e2a8855/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablefinance.dev](https://www.zero.xyz/host/stablefinance.dev/llms.txt)