Segment facts history

Use this route to compare a disclosed segment metric across recent annual or quarterly filings. Select metric first, then use segment_type when the workflow needs a product, geographic, or other dimension. Rows preserve the issuer's reported axes, members, units, reporting periods, and filing provenance; a missing segment or unsupported capability is not a zero value. Keep the returned accession, filing URL, and freshness fields with any analysis. See API conventions and freshness and source evidence.

get/v1/statements/segmented-facts

Request

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

Query parameters

tickerstring

Issuer ticker, for example JPM. 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.

metric'revenue' | 'profit_loss' required

Required disclosed metric: revenue or profit_loss. Values remain in the returned XBRL unit and are only comparable when unit, period, and segment definition align.

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; do not infer an omitted geographic or product split.

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 SegmentedFactSeries with bounded records and request metadata.

object'segmented_fact_series' required
idstring required
createdAtstring required
livemodeboolean required
entityIdstring required
tickerstring nullable required
companyNamestring required
period'annual' | 'quarterly' required
metric'revenue' | 'profit_loss' required
capabilityobject
requestIdstring
traceparentstring

Changes

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