---
title: "Get Segment Research"
method: GET
path: "/tickers/{ticker}/research/segments"
tags: ["research"]
---

# Get Segment Research

`GET /tickers/{ticker}/research/segments`

## Request

- Base URL: `https://api.tickertrac.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tickertrac.com/tickers/{ticker}/research/segments`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Return retained issuer segment history without provider or model calls.

## Path parameters

- `ticker` string, required

## Response `200`

Successful Response

- SegmentResearchOut
  - `ticker` string, required
  - `coverage_status` 'ready' | 'not_available', required
  - `coverage_detail` string, required
  - `segments` CompanySegmentOut[]
    - `id` integer, required
    - `issuer_segment_key` string, required
    - `canonical_name` string, required
    - `dimension` 'business' | 'geography' | 'product' | 'other', required
    - `identity_source` 'issuer_reported' | 'provider' | 'operator', required
    - `label_history` SegmentLabelHistoryOut[]
      - `reported_label` string, required
      - `normalized_label` string, required
      - `first_observed_at` string, date-time, required
      - `last_observed_at` string, date-time, required
    - `facts` SegmentFactOut[]
      - `id` integer, required
      - `fact_set_id` integer, required
      - `metric` string, required
      - `value` string, required
      - `unit` string, required
      - `currency` string, nullable, required
      - `dimension` 'business' | 'geography' | 'product' | 'other', required
      - `period_type` 'quarterly' | 'annual', required
      - `period_start` string, date, nullable, required
      - `period_end` string, date, required
      - `fiscal_year` integer, nullable, required
      - `fiscal_quarter` integer, nullable, required
      - `reported_label` string, required
      - `reported_total` string, nullable, required
      - `summed_segment_value` string, required
      - `reconciliation_status` 'reconciled' | 'unreconciled' | 'not_tested', required
      - `reconciliation_difference` string, nullable, required
      - `reconciliation_tolerance` string, nullable, required
      - `provider` string, required
      - `provider_display_name` string, required
      - `source_url` string, required
      - `source_locator` string, required
      - `published_at` string, date-time, nullable, required
      - `observed_at` string, date-time, required
      - `ingested_at` string, date-time, required
      - `superseded_at` string, date-time, nullable, required
      - `is_current` boolean, required

## Other responses

- `422`: Validation Error

---

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