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.

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).

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' \
  -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
- 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",
        "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

{}