Revenue Segmentation

GET/api/financials/revenue-segmentation

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.

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/revenue-segmentation?symbol=AAPL&cik=320193&cusip=037833100&composite_figi=BBG000B9XRY4&share_class_figi=BBG001S5N8V8' \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

Responses

200 OK

Revenue segmentation by geography and product, organized by period

Response schema

array of:

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

Example response

[
  {
    "period": "2024-03-29",
    "fiscalYear": 2024,
    "fiscalPeriod": {},
    "unit": "USD",
    "geography": {
      "countries": [
        {
          "code": "US",
          "name": "United States",
          "continent": "Americas",
          "value": 167045000000
        }
      ],
      "usStates": [
        {
          "code": "CA",
          "name": "California",
          "value": 1269000
        }
      ],
      "regions": [
        {
          "member": "srt:AmericasMember",
          "name": "Americas",
          "continent": "Americas",
          "value": 167045000000,
          "explainedByCountries": 167045000000,
          "other": 0
        }
      ],
      "residuals": [
        {
          "member": "jhx:OtherCountriesMember",
          "name": "Other Countries",
          "value": 25000000000
        }
      ]
    },
    "product": [
      {
        "member": "aapl:iPhoneMember",
        "name": "i Phone",
        "value": 201183000000
      }
    ],
    "dateFiled": "2024-11-01"
  }
]

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

{}