Plan: Free and above · Credits: 1 per call
What You Can Use Segmented Financials For
Track a company’s revenue mix by business line or geography over time. See which segment drove a change in consolidated results. Detect a segment redefinition, which shows up as an axis changing between periods. Compare a company against itself before attempting any cross-company comparison.Segmented Financials Coverage
Coverage is SEC filers that disclose segment data in their XBRL exhibits. Income-statement segmentation is the most widely reported; balance-sheet and cash-flow segmentation are much sparser, so an empty response on those is common and is not an error.Why Segment Axes Are Not Comparable Across Companies
Segment axes are defined by the filer, not by a standard. Two companies in the same industry rarely cut revenue the same way, and a single company can change its own axes between years after a reorganisation. Compare a company against itself first. Cross-company segment comparison requires deciding, case by case, that two differently named axes describe the same thing — a judgement this dataset deliberately does not make on your behalf.Key Segmented Financials Fields
Rows carry the segment axis and member as the company named them, the line-item values disclosed for that member,report_period, period, currency and accounting_standard.
The Four Segment Endpoints
The combined segments endpoint returns segmentation across statements and is the usual entry point. Three statement-specific endpoints return the same structure narrowed to one statement: income-statement segments, balance-sheet segments and cash-flow segments. The wrapper keys areincome_statement_segments, balance_sheet_segments and cash_flow_statement_segments respectively.
Segmented Financials Date Convention
report_period is the end of the fiscal period the segment figures cover. period defaults to annual on these endpoints and also accepts quarterly.
Segmented Financials Sources
Segment figures are read from the company’s own XBRL segment axes in its SEC filings, as reported. No axis is renamed, merged or mapped.Query Segmented Financials
Use the segments endpoint. One ofticker or cik is required; period is optional here and defaults to annual.
string
Trading symbol. One of
ticker or cik is required.string
SEC Central Index Key. One of
ticker or cik is required.string
default:"annual"
annual or quarterly.string
Exact period end,
YYYY-MM-DD. The _gte, _lte, _gt and _lt variants bound a range.integer
default:"4"
Number of period rows to return, newest first.