# Financial Datasets AI – Income Statement Segment Breakdowns

> Financial Datasets AI – Income Statement Segment Breakdowns is a paid API for AI agents from api.financialdatasets.ai, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-18).

Returns revenue, operating income, and depreciation broken down by product line and business segment for a company, as tagged in SEC filings, for annual or quarterly periods.

## Facts

- Endpoint: GET https://api.financialdatasets.ai/financials/income-statements/segments?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/financial-datasets-ai-income-statement-segment-breakdowns-aa3deba5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nP4Py3KeXuA40xitvYv9_

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-income-statement-segment-breakdowns-aa3deba5
```

Example prompt: Pull Apple's quarterly income statement segment breakdown — I want to see revenue and operating income by product line for each quarter since 2022-01-01.

## When to prefer this

Choose this endpoint when you need sub-total financial metrics broken out by business segment or product line rather than the consolidated income statement totals. Prefer it over the consolidated income statement endpoint when analyzing how individual divisions (e.g., AWS vs. Amazon retail) contribute to overall performance, or when building segment-trend models. Use the all-segments combined endpoint if you also need balance sheet or cash flow segment data in one call.

## Known failure modes

- Missing required 'period' parameter returns a 400 validation error
- Invalid ticker or CIK with no matching company returns empty results or 404
- Report period date filter with no matching filings returns empty array
- Non-Professional plan attempting Professional-tier data may be blocked or require upgrade
- Pagination cursor from a previous session may expire or be invalid
- Rate limiting or payment failure (x402) may return 402 or 429 status codes

## How this service works

Income statement segment breakdowns for a company by ticker or CIK: revenue, operating income and depreciation by product line and business segment, as tagged in SEC filings. Period annual or quarterly; filter by report_period. Use when an agent needs revenue by product or segment rather than the consolidated total. Non-Professional use; Professional use needs a plan at financialdatasets.ai.

## Output

Returns an array of segment-level income statement records, each containing the company identifier, report period, period type (annual/quarterly), and segment-specific metrics including revenue, operating income, and depreciation, organized by product line or business unit as tagged in SEC filings. Pagination is supported via cursor and next_page_url.

## 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 periods to return."
      },
      "cursor": {
       "type": "string",
       "description": "Opaque pagination cursor from a previous response's next_page_url."
      },
      "period": {
       "enum": [
        "annual",
        "quarterly"
       ],
       "type": "string",
       "description": "The time period of the data."
      },
      "ticker": {
       "type": "string",
       "description": "The ticker symbol."
      },
      "report_period": {
       "type": "string",
       "description": "Filter by exact report period 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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/financial-datasets-ai-income-statement-segment-breakdowns-aa3deba5/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)
