---
title: "Get Ticker Coverage"
method: GET
path: "/tickers/{ticker}/coverage"
tags: ["research"]
---

# Get Ticker Coverage

`GET /tickers/{ticker}/coverage`

## 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}/coverage`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

One honest coverage envelope for onboarding and research UI.

A ticker being in the supported universe is not a promise that every source is
available. Keeping those two ideas separate prevents a successful price lookup
from being presented as complete filing/expectations coverage.

## Path parameters

- `ticker` string, required

## Response `200`

Successful Response

- TickerCoverageOut
  - `ticker` string, required
  - `universe_status` 'supported' | 'unsupported', required
  - `universe_detail` string, required
  - `overall_status` 'ready' | 'onboarding' | 'partial' | 'unsupported', required
  - `sources` TickerSourceCoverageOut[], required
    - `source` 'filings' | 'price_history' | 'consensus' | 'earnings_results' | 'earnings_calendar' | 'ir_presentations' | 'segments' | 'issuer_annual_reports' | 'issuer_interim_reports', required
    - `status` 'partial' | 'disabled' | 'not_started' | 'pending' | 'ready' | 'stale' | 'unavailable' | 'failed' | 'not_refreshed' | 'licensing_required', required
    - `detail` string, nullable, required
    - `last_attempted_at` string, date-time, nullable
    - `last_success_at` string, date-time, nullable
    - `record_count` integer
    - `metric_count` integer
    - `period_count` integer
    - `earliest_period_end` string, date, nullable
    - `latest_period_end` string, date, nullable

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