Business Segmentation

GET/api/financials/business-segmentation

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.

Get API key Try it live in the API explorer

Query parameters

symbol string optional min length 1 · max length 10

Stock ticker symbol. Identify the entity by exactly one of: symbol, cik, cusip, composite_figi, or share_class_figi. At least one is required.

Example: AAPL
cik integer optional

SEC Central Index Key (CIK).

Example: 320193
cusip string optional min length 9 · max length 9

CUSIP identifier (9 characters).

Example: 037833100
composite_figi string optional

Composite OpenFIGI identifier.

Example: BBG000B9XRY4
share_class_figi string optional

Share-class OpenFIGI identifier.

Example: BBG001S5N8V8
period string (enum) optional

The reporting period: annual returns FY entries; quarter returns Q1-Q4 with Q2/Q3 synthesized from cumulative H1/9M as needed.
limit integer optional min 1 · max 80 · default 4

Maximum number of periods to return (may be clamped by subscription tier).
includeSubtotals boolean optional default false

Include subtotal rollup members. Off by default so the returned segments can be summed without double-counting.

Example: false

Example request

curl 'https://api.stockfit.io/v1/api/financials/business-segmentation?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8&includeSubtotals=false' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Per-segment metrics, organized by period

Response schema

array of:

period string (date)
fiscalYear integer
fiscalPeriod string (enum)
Fiscal period of a reported value: `FY` (annual) or `Q1`-`Q4` (quarterly).
Allowed values: FY, Q1, Q2, Q3, Q4
unit string
segments array of object
array of:
- member string
  Raw XBRL member QName
- name string
  Derived display label
- role string (enum)
  What this member contributes to the total. `subtotal` only appears when `includeSubtotals=true`.
  Allowed values: segment, elimination, reconciling, subtotal
- 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) | null
SEC filing acceptance date for the source 10-K/10-Q.

Example response

[
  {
    "period": "2026-03-31",
    "fiscalYear": 2026,
    "fiscalPeriod": {},
    "unit": "USD",
    "segments": [
      {
        "member": "mck:NorthAmericanPharmaceuticalSegmentMember",
        "name": "North American Pharmaceutical Segment",
        "role": "segment",
        "metrics": {
          "revenue": 336652000000,
          "operatingIncome": 4015000000,
          "grossProfit": 12500000000,
          "assets": 48000000000,
          "goodwill": 4200000000,
          "depreciationAmortization": 350000000,
          "capex": 280000000,
          "netIncome": 2800000000
        }
      }
    ],
    "dateFiled": "2026-05-15"
  }
]

400 Bad Request

Invalid parameters or symbol not found

Response schema

error string
Human-readable error message

Example response

{}

403 Forbidden

Feature not available on current plan

Response schema

error string
Human-readable error message

Example response

{}