---
title: "Business Segmentation"
method: GET
path: "/api/financials/business-segmentation"
tags: ["Financials"]
---

# Business Segmentation

`GET /api/financials/business-segmentation`

![Starter](https://img.shields.io/badge/Starter-3b82f6) ![Stock](https://img.shields.io/badge/Stock-f97316) ![Pro](https://img.shields.io/badge/Pro-8b5cf6)

Returns per-business-segment financial metrics — revenue, operating income, gross profit, total assets, goodwill, D&A, capex, and net income — sourced from XBRL dimensional facts tagged on the business-segments axis in 10-K / 10-Q / 20-F filings.

Each metric is `null` when the filer didn't tag that concept for the segment in that period. Coverage varies by company: most disclose revenue and operating income per segment; identifiable assets and capex are less universal.

**Member roles.** Segment tables mix real segments with rollups and contra rows, so every entry carries a `role`:

| role | meaning |
|------|---------|
| `segment` | An additive reportable segment. |
| `elimination` | Intersegment or consolidation eliminations — a contra row, usually negative. |
| `reconciling` | A bridging item such as corporate/non-segment costs. |
| `subtotal` | A rollup **of** other members (e.g. `us-gaap:ReportableSegmentsMember`). Excluded by default. |

`segment` + `elimination` + `reconciling` reconcile to the consolidated figure. `subtotal` rows are aggregates of the other members and would double-count if summed alongside them, so they are omitted unless `includeSubtotals=true`.

## Query parameters

- `symbol` string
- `cik` integer
- `cusip` string
- `composite_figi` string
- `share_class_figi` string
- `period` 'annual' | 'quarter' — Base reporting period: `annual` or `quarter` (the periods companies actually report, without the derived `ttm` rollup).
- `limit` integer
- `includeSubtotals` boolean

## Response `200`

Per-segment metrics, organized by period

- object[]
  - `period` string, date
  - `fiscalYear` integer
  - `fiscalPeriod` 'FY' | 'Q1' | 'Q2' | 'Q3' | 'Q4' — Fiscal period of a reported value: `FY` (annual) or `Q1`-`Q4` (quarterly).
  - `unit` string
  - `segments` object[]
    - `member` string — Raw XBRL member QName
    - `name` string — Derived display label
    - `role` 'segment' | 'elimination' | 'reconciling' | 'subtotal' — What this member contributes to the total. `subtotal` only appears when `includeSubtotals=true`.
    - `metrics` object — Sparse — each key is present only when the filer tagged that concept for this segment in this period. Missing keys are omitted from the response (not serialized as `null`).
      - `revenue` number
      - `operatingIncome` number
      - `grossProfit` number
      - `assets` number
      - `goodwill` number
      - `depreciationAmortization` number
      - `capex` number
      - `netIncome` number
  - `dateFiled` string, date, nullable — SEC filing acceptance date for the source 10-K/10-Q.

## Other responses

- `400` — Invalid parameters or symbol not found
- `403` — Feature not available on current plan

---

[API](https://skmtc.net/stockfit/apis/stockfit-api.md) · [All operations](https://skmtc.net/stockfit/apis/stockfit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stockfit/stockfit-api/revisions/3d5897270d8a/schema)