Plan: Free and above · Credits: 1 per call · MCP tool:
get_segmented_financialsWhat 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 income-statement metrics are revenue, operating income, segment_profit — the filer’s own segment profit measure, named in each item’s measure — depreciation and premiums written. Every other metric by segment (EBITDA, margins, gross profit) is what the earnings release printed, in 8-K Segments; the two sources are independent and are never joined.
Add Up One Bucket, Never Several
Each metric holds one breakdown per bucket:segment, product and geography. Add up one bucket, never two. other holds reconciliation lines — segment totals, eliminations, corporate — and is not a breakdown; it does not sum to anything.
Gross and External Segment Figures
Everysegment item says its basis:
When the filing tags more than one basis or the inter-segment amounts, the item also carries
gross, external and intersegment as filed, so gross − intersegment = external. A one-item segment_total bucket carries the same fields for the whole table, with the segments’ inter-segment amounts summed.
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.