---
title: "Segment facts history"
method: GET
path: "/v1/statements/segmented-facts"
---

# Segment facts history

`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

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](/api-conventions) and [freshness and source evidence](/freshness-and-trust).

## Query parameters

- `ticker` string
- `symbol` string
- `cik` string
- `metric` 'revenue' | 'profit_loss', required
- `period` 'annual' | 'quarterly' | 'quarter' | 'q'
- `segment_type` 'geographic' | 'product' | 'other'
- `limit` integer
- `segment_limit` integer
- `segmentLimit` integer
- `submission_file_limit` integer
- `submissionFileLimit` integer

## Response `200`

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

- SegmentedFactSeries
  - `object` 'segmented_fact_series', required
  - `id` string, required
  - `createdAt` string, required
  - `livemode` boolean, required
  - `entityId` string, required
  - `ticker` string, nullable, required
  - `companyName` string, required
  - `period` 'annual' | 'quarterly', required
  - `metric` 'revenue' | 'profit_loss', required
  - `capability` object
  - `records` object[], required
    - `segmentAxis` string, required
    - `segmentMember` string, required
    - `segmentLabel` string, required
    - `segmentType` 'geographic' | 'product' | 'other'
    - `axisFamily` string, required
    - `hierarchyDepth` integer, required
    - `isMostGranularSibling` boolean, required
    - `metricKey` 'revenue' | 'profit_loss', required
    - `taxonomy` string, required
    - `tag` string, required
    - `unit` string, required
    - `value` number, required
    - `periodStart` string, nullable, required
    - `periodEnd` string, required
    - `filingDate` string, required
    - `reportDate` string, nullable, required
    - `form` string, required
    - `accessionNumber` string, required
    - `capability` object
    - `trace` Trace
      - `object` 'trace', required
      - `id` string, required
      - `createdAt` string, required
      - `livemode` boolean, required
      - `kind` 'filing_fact' | 'filing_excerpt' | 'derived_metric' | 'source_record', required
      - `status` 'supported' | 'degraded' | 'unavailable', required
      - `title` string, required
      - `summary` string, nullable
      - `formula` string, nullable
      - `filing` object, nullable
        - `accessionNumber` string, required
        - `filingUrl` string, uri, required
        - `pdfUrl` string, uri, nullable
        - `viewerUrl` string, uri, nullable
        - `filingDate` string, nullable
        - `reportDate` string, nullable
        - `form` string, nullable
        - `page` integer, nullable
        - `region` object, nullable
          - `status` 'supported' | 'degraded' | 'unavailable', required
          - `kind` 'inline_xbrl_fact' | 'html_text_range', nullable
          - `startOffset` integer, nullable
          - `endOffset` integer, nullable
          - `snippet` string, nullable
          - `viewerFragment` string, nullable
      - `sourceRecord` object, nullable
        - `sourceName` string, required
        - `sourceKind` string, required
        - `sourceKey` string, required
        - `sourceUrl` string, uri, required
        - `publicationTs` string, nullable
        - `firstObservedAt` string, nullable
        - `lastObservedAt` string, nullable
        - `latestIngestedAt` string, nullable
        - `latestHttpStatus` integer, nullable
        - `latestStorageRef` string, nullable
        - `lineage` object
        - `metadata` object
        - `error` string, nullable
      - `nodes` object[], required
        - `id` string, required
        - `kind` 'xbrl_fact' | 'filing_document' | 'filing_excerpt' | 'derived_formula' | 'source_document' | 'source_record', required
        - `source` 'disclosed' | 'derived' | 'observed', required
        - `label` string, required
        - `value` union
          - string
          - number
        - `unit` string, nullable
        - `taxonomy` string, nullable
        - `tag` string, nullable
        - `filingUrl` string, uri, nullable
        - `documentUrl` string, uri, nullable
        - `pdfUrl` string, uri, nullable
        - `viewerUrl` string, uri, nullable
        - `accessionNumber` string, nullable
        - `sourceName` string, nullable
        - `sourceKind` string, nullable
        - `sourceKey` string, nullable
        - `sourceSurface` string, nullable
        - `publishedAt` string, nullable
        - `page` integer, nullable
        - `region` object, nullable
          - `status` 'supported' | 'degraded' | 'unavailable', required
          - `kind` 'inline_xbrl_fact' | 'html_text_range', nullable
          - `startOffset` integer, nullable
          - `endOffset` integer, nullable
          - `snippet` string, nullable
          - `viewerFragment` string, nullable
        - `periodStart` string, nullable
        - `periodEnd` string, nullable
        - `segmentAxis` string, nullable
        - `segmentMember` string, nullable
        - `segmentLabel` string, nullable
    - `provenance` ResponseMetadata, required
      - `source` string, required
      - `sourceLabel` string
      - `sourceAgency` string
      - `canonicality` string
      - `fallbackPolicy` string
      - `accessionNumber` string, nullable, required
      - `filingUrl` string, uri, required
      - `acceptedAt` string, nullable
      - `retrievedAt` string, required
      - `parserVersion` string, required
  - `provenance` ResponseMetadata, required
    - `source` string, required
    - `sourceLabel` string
    - `sourceAgency` string
    - `canonicality` string
    - `fallbackPolicy` string
    - `accessionNumber` string, nullable, required
    - `filingUrl` string, uri, required
    - `acceptedAt` string, nullable
    - `retrievedAt` string, required
    - `parserVersion` string, required
  - `freshness` FreshnessMetadata: Freshness of the record. For SEC filings, freshness measures the delay between SEC acceptance (`sourcePublishedAt`) and when the record became available in the API — not the age of the document. Statuses: `current` (recently published and available promptly), `archival` (an immutable historical document held in full; its availability delay is not a freshness signal), `degraded`/`stale` (a recently published filing that became available later than the freshness thresholds allow), `fresh` (continuously refreshed datasets recently observed at source), `unknown` (no timestamps). An old immutable filing is never `stale` simply because it was published long ago. `lagMs` is the publish-to-availability delay in milliseconds.
    - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
    - `asOf` string, required
    - `sourcePublishedAt` string, nullable
    - `lagMs` integer, nullable
  - `materialization` MaterializationMetadata
    - `parserVersion` string, required
    - `materializationVersion` string, required
  - `validation` ValidationStatus
    - `status` 'validated' | 'unvalidated' | 'degraded', required
    - `confidence` 'high' | 'medium' | 'low', nullable
    - `validatedAt` string, nullable
    - `validationPipeline` string, nullable
    - `exceptions` string[]
  - `requestId` string
  - `traceparent` string

## Other responses

- `default`: Contract-aware error response

---

[API](https://skmtc.dev/turos/apis/turos-api.md) · [All operations](https://skmtc.dev/turos/apis/turos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/turos/apis/turos-api/revisions/a68d3ec80a56?raw)