segment_name, the cut it belongs to, whether it may be added, and the verbatim quote it was read from.
Plan: Free and above · Credits: 1 per call
What You Can Use Segment Breakouts For
See how a quarter split across a company’s reportable segments, product lines or regions, the day it was announced. Track segment KPIs the financial statements never carry. Compare the as-printed split with the audited segment detail.Split on segment_axis Before Summing
Read segment_name
A release often prints the segment name only in the row label and leaves the segment field empty.segment_name resolves it. segment_as_extracted keeps the field as extracted and label_qualifier the part of the label the name came from.
Not Every Breakout Is Here, on Purpose
A row counts as a segment only when the release named the segment in its own field. When the name appears only inside the row label, the row cannot be told apart from a wording variant, so it is left out rather than guessed at. Cisco’s Q2 FY26 geographies are the worked case: they are not here. They are reachable through Reported Earnings Figures with nolevel.
Key Segment Breakout Fields
Each row carries the same release and value fields as Company Measures —ticker, company_id, year, quarter, observed_at, doc_id, source_ref, metric_key, basis, period, period_end, label, value_text, value_low, value_high, value_unit, yoy, quote, value_is_change and unit_check — plus segment_name, segment_as_extracted, label_qualifier, segment_axis and segment_role.
Read value_is_change before using a number: when true, the figure is a change, not a level.
Segment Breakouts Coverage
Companies whose releases break a line out and name the segment in its own field. The floor moves as the backfill proceeds — readcoverage.available_from on the response.
Segment Breakouts Date Convention
year and quarter are the fiscal year and quarter of the release. period is the period the figure is for, as the release labelled it. Rows are returned newest release first.
GET /v1/companies/{company_id}/8k-segments
Segment, product and geography breakouts from one company’s earnings releases, newest first. The identifier is expanded to every ticker the company is known by.string
required
A ticker,
company_id, CIK or ISIN.string
Normalised metric, for example
revenue or operating_income. The pre-normalisation spelling is accepted too.string
The period the figure is for, exactly as the release labelled it, for example
Q3-FY26.integer
Fiscal year of the release.
integer
Fiscal quarter of the release, 1 to 4.
integer
default:"100"
Rows per page, between 1 and 1000. Page through with
cursor.