Segment revenue history

Use this route to analyze revenue splits the issuer actually disclosed in XBRL. Choose annual or quarterly cadence and, when useful, narrow to a product, geographic, or other reported dimension. Records retain the reported unit, period, segment hierarchy, capability status, and filing provenance; they are not a modeled revenue allocation. Preserve the returned accession, filing URL, and freshness fields before aggregating or presenting the result. See API conventions and freshness and source evidence.

get/v1/statements/segmented-revenues

Request

  • Base URL: https://api.turos.app
  • URL: https://api.turos.app/v1/statements/segmented-revenues
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Query parameters

tickerstring

Issuer ticker, for example PFE. Either ticker, symbol, or cik is required.

symbolstring

Alias for ticker, for customers coming from market-data APIs.

cikstring

Issuer CIK. Either ticker, symbol, or cik is required.

period'annual' | 'quarterly' | 'quarter' | 'q'

Reporting cadence to select: annual or quarterly. quarter and q are aliases for quarterly; compare values only within like-for-like periods.

segment_type'geographic' | 'product' | 'other'

Optional disclosed-dimension filter. Omit it to retain all supported dimensions; no row does not establish that revenue was zero.

limitinteger

Maximum reporting periods to return (1-6). This bounds returned history rather than proving older disclosure is absent.

segment_limitinteger

Alias for limit when requesting bounded segment rows.

segmentLimitinteger

Alias for segment_limit.

submission_file_limitinteger

Maximum SEC submission-history files to inspect (1-6). This bounds historical search depth, not the number of returned segment rows.

submissionFileLimitinteger

Alias for submission_file_limit.

Response

Successful response. Returns a SegmentedRevenueSeries with bounded records and request metadata.

object'segmented_revenue_series' required
idstring required
createdAtstring required
livemodeboolean required
entityIdstring required
tickerstring nullable required
companyNamestring required
period'annual' | 'quarterly' required
capabilityobject
requestIdstring
traceparentstring

Changes

No recorded changes to this operation across all 1 revision of this API.