Skip to content

GET /v3/companies/{cik_or_ticker}/segments

Get a company's segment breakdowns by period.

Built from the company's own dimensional facts: business segment, product (or service), geography, and major customer. Values are revenue, operating income, assets, long-lived assets, D&A, capital expenditure, and (from 2024) segment expenses. Each member has the company's own label and the fact behind it. Reconciling items keep their sign. The consolidated value comes with a check: pass, fail (served and flagged), not_evaluable, or not_applicable for major customers.

API key: required. See Authentication.

Group: Financial data (XBRL)

Try it

Parameters

The company's CIK, such as 320193, or its ticker, such as AAPL. Leading zeros are optional. A ticker is looked up in SEC's ticker file, in any letter case. An unknown ticker is a 400 unknown_ticker error. The resolved member gives the CIK.

Period ends per page, newest first, 1 to 200. Default 1: the latest fiscal year.

More parameters (9)

Axes: segment, product, geography, or customer. Separate several with commas. Default: all. Separate several values with commas.

Value kinds: revenue, operating_income, assets, long_lived_assets, depreciation_amortization, capital_expenditure, or expense. Separate several with commas. Default: all. Separate several values with commas.

Period classes: annual (year ends, with the instants on those dates), quarterly, ytd (half years, nine months), instant, or all. Separate several with commas. Default annual; with period, all. Separate several values with commas.

Periods ending on or after this date, YYYY-MM-DD.

Periods ending on or before this date, YYYY-MM-DD.

One period as START/END, or END alone for every period ending that day (YYYY-MM-DD). Not with from or to.

next_cursor from the previous page. Use the same filters.

latest (default: as known at as_of) or first_reported (the first filing that stated the breakdown).

Point in time, with view=latest: each value as known from filings accepted by then. YYYY-MM-DDTHH:MM:SSZ in UTC (add up to 6 decimals for an exact time), or YYYY-MM-DD for the whole UTC day.

Without a key the API answers 401; you can still send the request to see that.
Python
import os
import requests

r = requests.get(
    "https://api.secblast.com/v3/companies/AAPL/segments",
    params={"limit": "2"},
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

Response

Nothing has been sent yet.

Parameters

NameInTypeRequiredDefaultDescription
cik_or_tickerpathstringyesThe company's CIK, such as 320193, or its ticker, such as AAPL. Leading zeros are optional. A ticker is looked up in SEC's ticker file, in any letter case. An unknown ticker is a 400 unknown_ticker error. The resolved member gives the CIK.
axisquerycomma-separated list of stringnoAxes: segment, product, geography, or customer. Separate several with commas. Default: all.
kindquerycomma-separated list of stringnoValue kinds: revenue, operating_income, assets, long_lived_assets, depreciation_amortization, capital_expenditure, or expense. Separate several with commas. Default: all.
periodsquerycomma-separated list of stringnoannualPeriod classes: annual (year ends, with the instants on those dates), quarterly, ytd (half years, nine months), instant, or all. Separate several with commas. Default annual; with period, all.
fromquerystringnoPeriods ending on or after this date, YYYY-MM-DD.
toquerystringnoPeriods ending on or before this date, YYYY-MM-DD.
periodquerystringnoOne period as START/END, or END alone for every period ending that day (YYYY-MM-DD). Not with from or to.
limitqueryintegerno1Period ends per page, newest first, 1 to 200. Default 1: the latest fiscal year.
cursorquerystringnonext_cursor from the previous page. Use the same filters.
viewquerystringnolatestlatest (default: as known at as_of) or first_reported (the first filing that stated the breakdown). One of: latest, first_reported.
as_ofquerystringnoPoint in time, with view=latest: each value as known from filings accepted by then. YYYY-MM-DDTHH:MM:SSZ in UTC (add up to 6 decimals for an exact time), or YYYY-MM-DD for the whole UTC day.

Details

Versions: one filing's breakdown per period, axis, and kind; use view latest (as of a time) or first_reported. Deleted filings are not read and are listed in excluded.

Responses

StatusBodyDescription
200XbrlCompanySegments (application/json)OK
400Problem (application/problem+json)Invalid or unknown parameter.
401Problem (application/problem+json)Missing, invalid, or inactive API key (code unauthorized), or a refused access token (code invalid_token: malformed, unknown key, bad signature, expired, wrong issuer or audience, revoked grant). WWW-Authenticate names the protected-resource metadata (RFC 9728).
404Problem (application/problem+json)Not found.
503Problem (application/problem+json)Database unavailable; retry after the Retry-After delay.
defaultProblem (application/problem+json)Any other error (405, 500, 504).

Response body

A 200 carries a XbrlCompanySegments object.

FieldTypeRequiredDescription
accuracyobjectnoHow accurate and complete each requested kind is, measured on filings held back from rule building. These numbers are fixed per version.
as_ofstring | nullyes
axesarray of stringyes
cikstringyes
dataarray of objectyes
excludedExcludedyes
excluded_totalintegeryes
fromstring | nullyes
has_morebooleanyes
kindsarray of stringyes
limitintegeryesPeriod end dates per page. The default, 1, gives the latest fiscal year.
next_cursorstring | nullyesSend this as cursor, with the same filters, for the next page of earlier periods. Null on the last page.
periodstring | nullyes
periodsstringyesThe period classes served. The default, annual, gives fiscal year ends with their years and instants.
rulestringyes
rulesobjectyes
tostring | nullyes
viewstringyesOne of: latest, first_reported.

Example request

Python
import os
import requests

r = requests.get(
    "https://api.secblast.com/v3/companies/AAPL/segments",
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())

Example answer

Python
import os
import requests

r = requests.get(
    "https://api.secblast.com/v3/companies/AAPL/segments",
    params={"limit": "2"},
    headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
    timeout=30,
)
r.raise_for_status()
print(r.json())
JSON
{
  "accuracy": {
    "basis": "holdout3: 50 companies, FY2023 and FY2024 10-Ks, values checked against SEC's R pages; precision = correct / served, coverage = served / labelled",
    "kinds": {
      "assets": {
        "correct": 121,
        "coverage_pct": 91.7,
        "precision_pct": 98.37,
        "served": 123
      },
      "capital_expenditure": {
        "correct": 87,
        "coverage_pct": 94.6,
        "precision_pct": 88.78,
        "served": 98
      },
      "depreciation_amortization": {
        "correct": 141,
        "coverage_pct": 94,
        "precision_pct": 96.58,
        "served": 146
      },
      "expense": {
        "correct": 217,
        "coverage_pct": 90.2,
        "precision_pct": 94.76,
        "served": 229
      },
      "long_lived_assets": {
        "correct": 110,
        "coverage_pct": 94.8,
        "precision_pct": 100,
        "served": 110
      },
      "revenue": {
        "correct": 811,
        "coverage_pct": 94.4,
        "precision_pct": 99.27,
        "served": 817
      },
      "segment_profit": {
        "correct": 119,
        "coverage_pct": 68,
        "precision_pct": 99.17,
        "served": 120
      }
    },
    "rules_version": "1.3.0"
  },
  "as_of": null,
  "axes": [
    "segment",
    "product"
  ],
  "cik": "0000320193",
  "data": [
    {
      "axes": [
        {
          "accession": "0000320193-26-000026",
          "axis": "segment",
          "breakdowns": [
            {
              "check": {
                "basis": "members",
                "difference": null,
                "status": "pass"
              },
              "rows": [
                {
                  "axis_qname": "us-gaap:StatementBusinessSegmentsAxis",
                  "concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",
                  "concept_label": "Net sales",
                  "context_no": 150,
                  "fact_seq": 1085,
                  "flags": [],
                  "member": "aapl:AmericasSegmentMember",
                  "member_label": "Americas",
                  "member_standard": null,
                  "role": "member",
                  "source": null,
                  "status": "ok",
                  "unit_norm": "iso4217:USD",
                  "value": "198083000000",
                  "weight": 1
                },
                {
                  "axis_qname": "us-gaap:StatementBusinessSegmentsAxis",
                  "concept": "us-gaap:RevenueFromContractWithCustomerExcludingAssessedTax",
                  "concept_label": "Net sales",
                  "context_no": 151,
                  "fact_seq": 1086,
                  "flags": [],
                  "member": "aapl:EuropeSegmentMember",
                  "member_label": "Europe",
                  "member_standard": null,
                  "role": "member",
                  "source": null,
                  "status": "ok",
                  "unit_norm": "iso4217:USD",
                  "value": "127604000000",
                  "weight": 1
                }
              ]
            }
          ],
          "filing": {
            "accepted_at": "2026-11-03T13:05:15Z",
            "filing_date": "2026-11-03",
            "form_type": "10-K"
          },
          "incarnations": 1,
          "kind": "revenue"
        },
        {
          "accession": "0000320193-26-000026",
          "axis": "segment",
          "breakdowns": [
            {
              "check": {
                "basis": null,
                "difference": "37125000000",
                "status": "fail"
              },
              "rows": [
                {
                  "axis_qname": "us-gaap:StatementBusinessSegmentsAxis",
                  "concept": "us-gaap:OperatingIncomeLoss",
                  "concept_label": "Operating income",
                  "context_no": 150,
                  "fact_seq": 1120,
                  "flags": [
                    "check_fail"
                  ],
                  "member": "aapl:AmericasSegmentMember",
                  "member_label": "Americas",
                  "member_standard": null,
                  "role": "member",
                  "source": null,
                  "status": "ok",
                  "unit_norm": "iso4217:USD",
                  "value": "86008000000",
                  "weight": 1
                },
                {
                  "axis_qname": "us-gaap:StatementBusinessSegmentsAxis",
                  "concept": "us-gaap:OperatingIncomeLoss",
                  "concept_label": "Operating income",
                  "context_no": 151,
                  "fact_seq": 1121,
                  "flags": [
                    "check_fail"
                  ],
                  "member": "aapl:EuropeSegmentMember",
                  "member_label": "Europe",
                  "member_standard": null,
                  "role": "member",
                  "source": null,
                  "status": "ok",
                  "unit_norm": "iso4217:USD",
                  "value": "58098000000",
                  "weight": 1
                }
              ]
            }
          ],
          "filing": {
            "accepted_at": "2026-11-03T13:05:15Z",
            "filing_date": "2026-11-03",
            "form_type": "10-K"
          },
          "incarnations": 1,
          "kind": "segment_profit"
        }
      ],
      "period": {
        "class": "year",
        "days": 364,
        "end": "2026-09-26",
        "start": "2025-09-28"
      }
    },
    {
      "axes": [
        {
          "accession": "0000320193-26-000026",
          "axis": "geography",
          "breakdowns": [
            {
              "check": {
                "basis": "members",
                "difference": null,
                "status": "pass"
              },
              "rows": [
                {
                  "axis_qname": "srt:StatementGeographicalAxis",
                  "concept": "us-gaap:NoncurrentAssets",
                  "concept_label": "Long-lived assets",
                  "context_no": 177,
                  "fact_seq": 1224,
                  "flags": [],
                  "member": "country:US",
                  "member_label": "U.S.",
                  "member_standard": "country:US",
                  "role": "member",
                  "source": null,
                  "status": "ok",
                  "unit_norm": "iso4217:USD",
                  "value": "41386000000",
                  "weight": 1
                },
                {
                  "axis_qname": "srt:StatementGeographicalAxis",
                  "concept": "us-gaap:NoncurrentAssets",
                  "concept_label": "Long-lived assets",
                  "context_no": 179,
                  "fact_seq": 1226,
                  "flags": [],
                  "member": "aapl:OtherCountriesMember",
                  "member_label": "Other countries",
                  "member_standard": null,
                  "role": "member",
                  "source": null,
                  "status": "ok",
                  "unit_norm": "iso4217:USD",
                  "value": "10698000000",
                  "weight": 1
                }
              ]
            }
          ],
          "filing": {
            "accepted_at": "2026-11-03T13:05:15Z",
            "filing_date": "2026-11-03",
            "form_type": "10-K"
          },
          "incarnations": 1,
          "kind": "long_lived_assets"
        }
      ],
      "period": {
        "class": "instant",
        "days": 0,
        "end": "2026-09-26",
        "start": null
      }
    }
  ],
  "excluded": [],
  "excluded_total": 0,
  "from": null,
  "has_more": true,
  "kinds": [
    "revenue",
    "segment_profit"
  ],
  "limit": 2,
  "next_cursor": "eyJhIjoiMDAwMDMyMDE5My0y…",
  "period": null,
  "periods": "annual",
  "rule": "From the filing's own dimensional facts: one of the four axes alone (or with the operating-segments member), standard concepts only, per breakdown the concept with most members; members under the company's own label; reconciling items (corporate, eliminations, reconciling members) with their sign; t…(truncated)",
  "rules": {
    "version": "1.3.1"
  },
  "to": null,
  "view": "latest",
  "resolved": {
    "cik": "0000320193",
    "ticker": "AAPL",
    "ticker_file_date": "2026-11-18"
  }
}

More in Financial data (XBRL)

Previous: GET /v3/companies/{cik_or_ticker}/periods · Next: GET /v3/companies/{cik_or_ticker}/standard

Markdown version: /docs/reference/get-companies-cik-or-ticker-segments.md