# Financial Datasets Balance Sheet Segment Breakdowns

> Financial Datasets Balance Sheet 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-20).

Returns balance sheet segment breakdowns (assets, goodwill, long-lived assets by business segment) for a US company from SEC filings, filterable by ticker/CIK and period.

## Facts

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

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-balance-sheet-segment-breakdowns-de9586e4
```

Example prompt: Pull the annual balance sheet segment breakdown for Apple (ticker AAPL) from financialdatasets.ai — I want to see assets and goodwill broken out by business segment for the most recent 4 annual periods.

## When to prefer this

Choose this endpoint when you need balance sheet data disaggregated by business segment rather than consolidated totals. Use it over the standard balance sheets endpoint when the analysis requires understanding how assets or goodwill are distributed across a company's divisions or reporting segments as disclosed in SEC filings. Prefer this over manual SEC EDGAR parsing when you need structured, normalized segment data with period filtering.

## Known failure modes

- Missing required 'period' parameter returns a 400 validation error
- Neither ticker nor CIK provided may return empty results or error
- Invalid ticker symbol returns empty dataset or 404
- Date filter misformatted (not YYYY-MM-DD) causes a 400 error
- Company has no segment disclosures in SEC filings — returns empty array
- Rate limit or unpaid x402 payment returns 402 Payment Required
- CIK not matching any known company returns empty results

## How this service works

Balance sheet segment breakdowns for a company by ticker or CIK: assets, goodwill and long-lived assets by business segment, as tagged in SEC filings. Period annual or quarterly; filter by report_period. Use when an agent needs assets or goodwill by segment rather than the consolidated total. Non-Professional use; Professional use needs a plan at financialdatasets.ai.

## Output

A paginated list of balance sheet segment records, each containing the company identifier, report period, business segment name, and segment-level financial figures (assets, goodwill, long-lived assets) as tagged in SEC filings, plus 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 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-balance-sheet-segment-breakdowns-de9586e4/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)
