stocks_get_segmented_financials

Revenue or operating income broken out by segment, newest year first.

Use this for "how much of AAPL's revenue is Services vs iPhone?" or "what was each MSFT segment's operating income trend?" (e.g. stocks_get_segmented_financials(ticker="AAPL", axis="products_services", limit=3)). For company-wide totals use stocks_get_income_statements instead — that tool serves the consolidated statement; this one serves only the segment note's disaggregation of two of its lines, and repeats the consolidated figure just so the tie is checkable in place.

The result is the shared envelope: data holds the company identity (ticker, cik, company_name) plus the axis/metric echo and the bounded frames list; meta holds source ("sec_edgar_segments") and as_of (the freshest row-level timestamp on this page); pagination holds cursor paging state. To page, pass pagination.next_cursor back as cursor; when pagination.has_more is false you have reached the oldest year.

Each frame is one fiscal year: fiscal_year, fiscal_period, period_type, period_start/period_end, the frame-wide unit and currency (as filed, never converted), a segments list ordered largest first, and consolidated_total (the filer's undimensioned figure for the same tag, with its own accession_number/as_of; null when the filing tagged none). Each segment carries member (the verbatim XBRL member QName, e.g. "aapl:IPhoneMember"), member_label, member_role (operating | elimination | corporate_other), value (exact decimal as a JSON string), share_of_total (the member's fraction of the consolidated total, 4 decimals — revenue only, and null when the frame has no positive total), accession_number, and as_of. Segment sums need not foot exactly to the consolidated total: filers reconcile through unallocated items, which is why the total is served rather than assumed.

Coverage: the golden-set pilot universe, US-GAAP filers, annual 10-K frames only. member is the member the filer tagged, so a series is comparable to itself over time and to no other company — there is no cross-company segment mapping, and two filers' "Americas" are not the same thing. A covered company that does not disaggregate on the requested axis returns an empty frames list — honest coverage, not an error.

Errors carry a machine code: unknown_entity for a well-formed symbol we hold no mapping for, out_of_coverage for a company we hold no segment data for at all (outside the pilot universe), and bad_parameter for a non-ticker string, a malformed cursor, or metric="operating_income" on an axis other than business_segments.