---
title: "Company segments"
method: GET
path: "/v1/companies/segments"
---

# Company segments

`GET /v1/companies/segments`

## Request

- Base URL: `https://api.turos.app`
- URL: `https://api.turos.app/v1/companies/segments`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Use this route to understand an issuer's disclosed business mix across product, geographic, and operating axes. The service groups filing-derived segment facts, anchors each axis to reported revenue where possible, and returns a confidence signal; a `low_confidence` axis should not be presented as a complete revenue decomposition. Select annual or quarterly reporting before comparing results, and keep the returned filing provenance and freshness fields with any analysis. See [statements reference](/api-reference/statements) and [freshness and source evidence](/freshness-and-trust).

## Query parameters

- `ticker` string
- `symbol` string
- `cik` string
- `period` 'annual' | 'quarterly'
- `segment_type` 'product' | 'geographic' | 'operating'

## Response `200`

Successful response

- CompanySegments
  - `object` 'company_segments', required
  - `id` string, required
  - `createdAt` string, required
  - `livemode` boolean, required
  - `entityId` string, required
  - `ticker` string, nullable, required
  - `companyName` string, required
  - `period` 'annual' | 'quarterly', required
  - `segments` object[], required
    - `object` 'company_segment_axis', required
    - `axis` 'product' | 'geographic' | 'operating', required
    - `axisTag` string, required
    - `periodEnd` string, nullable, required
    - `priorPeriodEnd` string, nullable, required
    - `axisTotalRevenue` number, nullable, required
    - `companyRevenue` number, nullable, required
    - `tiesToRevenue` boolean, required
    - `confidence` 'reported' | 'low_confidence', required
    - `segments` object[], required
      - `object` 'company_segment', required
      - `segment` string, required
      - `revenue` number, nullable, required
      - `revenuePct` number, nullable, required
      - `profitLoss` number, nullable, required
      - `segmentMargin` number, nullable, required
      - `yoyGrowthPct` number, nullable, required
  - `note` string, nullable
  - `provenance` object, nullable
    - `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` object
    - `status` 'fresh' | 'current' | 'archival' | 'stale' | 'degraded' | 'unknown', required
    - `asOf` string, required
    - `sourcePublishedAt` string, nullable
    - `lagMs` integer, nullable
    - `synthetic` boolean

## 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)