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

# Revenue Segmentation

`GET /api/financials/revenue-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 revenue split by **geography** and **product** in a single response, period by period. Sourced from XBRL dimensional facts disclosed in 10-K / 10-Q / 20-F filings.

The `geography` field is partitioned into four buckets:
- `countries` — ISO 3166-1 alpha-2 leaves (e.g. `country:US`, `country:CN`) with country name and continent.
- `usStates` — US state postal codes (XBRL `stpr:XX` convention) with full state name. Present when a filer disclosed the metric by US state — common for state-tax disclosures, real-estate property counts, and similar US-internal breakdowns.
- `regions` — regional rollups the filer tagged directly (e.g. `srt:AmericasMember`, `us-gaap:EMEAMember`). For each region we also compute `explainedByCountries` (sum of country leaves whose continent matches the region — only attributed for true top-level continent rollups like Americas/Europe/Asia/Africa/Oceania) and `other` (the region total minus that sum), letting you surface a residual "other countries in region" bucket without losing data.
- `residuals` — filer-extension catch-alls like `jhx:OtherCountriesMember` that don't map to a continent.

The `product` field is a flat list of revenue-by-product members. Parent/leaf overlap (e.g. `us-gaap:ProductMember` alongside `aapl:iPhoneMember`) is preserved as-is; consumers can collapse subtotals client-side.

## 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

## Response `200`

Revenue segmentation by geography and product, organized by period

- object[]
  - `period` string, date — The fiscal period end date (YYYY-MM-DD)
  - `fiscalYear` integer — The company's fiscal year (handles non-December year-ends).
  - `fiscalPeriod` 'FY' | 'Q1' | 'Q2' | 'Q3' | 'Q4' — Fiscal period of a reported value: `FY` (annual) or `Q1`-`Q4` (quarterly).
  - `unit` string — Standardized unit of the values (usually `USD`)
  - `geography` object
    - `countries` object[]
      - `code` string — ISO 3166-1 alpha-2 country code
      - `name` string — Display name
      - `continent` string, nullable — Continent name
      - `value` number
    - `usStates` object[] — US-state-level disclosures (XBRL `stpr:XX` members). Empty array when no state-level breakdown was disclosed.
      - `code` string — US state postal code (e.g. CA, NY, TX)
      - `name` string — Full state name
      - `value` number
    - `regions` object[]
      - `member` string — Raw XBRL member QName
      - `name` string
      - `continent` string, nullable
      - `value` number — Revenue tagged on this region member
      - `explainedByCountries` number — Sum of country leaves in this continent
      - `other` number — Residual = value − explainedByCountries (revenue from countries within the region not separately disclosed)
    - `residuals` object[] — Filer-extension catch-all buckets like `jhx:OtherCountriesMember`
      - `member` string
      - `name` string
      - `value` number
  - `product` object[]
    - `member` string — Raw XBRL member QName
    - `name` string — Derived display label
    - `value` number
  - `dateFiled` string, date, nullable — SEC filing acceptance date for the source 10-K/10-Q. Use this to gate point-in-time data and avoid lookahead bias.

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