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
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
| 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 (application/json) | OK |
400 | Problem (application/problem+json) | Invalid or unknown parameter. |
401 | 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 (application/problem+json) | Not found. |
503 | Problem (application/problem+json) | Database unavailable; retry after the Retry-After delay. |
default | Problem (application/problem+json) | Any other error (405, 500, 504). |
Response body
A 200 carries a 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 | 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
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
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()){
"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