# 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](https://www.secblast.com/docs/authentication).

**Group:** [Financial data (XBRL)](https://www.secblast.com/docs/reference#financial-data-xbrl)

## Try it

Send this route from the page, signed in with your key, or from the [console](https://www.secblast.com/console).

## Parameters

| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
| `cik_or_ticker` | path | string | yes |   | 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. |
| `axis` | query | comma-separated list of string | no |   | Axes: segment, product, geography, or customer. Separate several with commas. Default: all. |
| `kind` | query | comma-separated list of string | no |   | Value kinds: revenue, operating_income, assets, long_lived_assets, depreciation_amortization, capital_expenditure, or expense. Separate several with commas. Default: all. |
| `periods` | query | comma-separated list of string | no | `annual` | 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. |
| `from` | query | string | no |   | Periods ending on or after this date, YYYY-MM-DD. |
| `to` | query | string | no |   | Periods ending on or before this date, YYYY-MM-DD. |
| `period` | query | string | no |   | One period as START/END, or END alone for every period ending that day (YYYY-MM-DD). Not with from or to. |
| `limit` | query | integer | no | `1` | Period ends per page, newest first, 1 to 200. Default 1: the latest fiscal year. |
| `cursor` | query | string | no |   | next_cursor from the previous page. Use the same filters. |
| `view` | query | string | no | `latest` | latest (default: as known at as_of) or first_reported (the first filing that stated the breakdown). One of: `latest`, `first_reported`. |
| `as_of` | query | string | no |   | 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. |

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

| Status | Body | Description |
|---|---|---|
| `200` | [XbrlCompanySegments](https://www.secblast.com/docs/reference/schemas#schema-xbrlcompanysegments) (`application/json`) | OK |
| `400` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Invalid or unknown parameter. |
| `401` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`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). |
| `404` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Not found. |
| `503` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Database unavailable; retry after the Retry-After delay. |
| `default` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Any other error (405, 500, 504). |

## Response body

A `200` carries a [XbrlCompanySegments](https://www.secblast.com/docs/reference/schemas#schema-xbrlcompanysegments) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `accuracy` | object | no | How accurate and complete each requested kind is, measured on filings held back from rule building. These numbers are fixed per version. |
| `as_of` | string \| null | yes |   |
| `axes` | array of string | yes |   |
| `cik` | string | yes |   |
| `data` | array of object | yes |   |
| `excluded` | [Excluded](https://www.secblast.com/docs/reference/schemas#schema-excluded) | yes |   |
| `excluded_total` | integer | yes |   |
| `from` | string \| null | yes |   |
| `has_more` | boolean | yes |   |
| `kinds` | array of string | yes |   |
| `limit` | integer | yes | Period end dates per page. The default, 1, gives the latest fiscal year. |
| `next_cursor` | string \| null | yes | Send this as cursor, with the same filters, for the next page of earlier periods. Null on the last page. |
| `period` | string \| null | yes |   |
| `periods` | string | yes | The period classes served. The default, annual, gives fiscal year ends with their years and instants. |
| `rule` | string | yes |   |
| `rules` | object | yes |   |
| `to` | string \| null | yes |   |
| `view` | string | yes | One 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`](https://www.secblast.com/docs/reference/get-companies-cik-or-ticker-periods) · Next: [`GET /v3/companies/{cik_or_ticker}/standard`](https://www.secblast.com/docs/reference/get-companies-cik-or-ticker-standard)
