---
title: "Get Ticker Statuses"
method: GET
path: "/tickers/status"
tags: ["tickers"]
---

# Get Ticker Statuses

`GET /tickers/status`

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

Batch dashboard preparation status without one HTTP/SQL fan-out per row.

## Query parameters

- `ticker` string[], required

## Response `200`

Successful Response

- TickerStatusOut[]
  - `ticker` string, required
  - `filings_status` 'pending' | 'ready' | 'unavailable' | 'failed', required
  - `filings_error` string, nullable, required
  - `price_history_status` 'pending' | 'ready' | 'unavailable' | 'failed', required
  - `price_history_error` string, nullable, required
  - `earnings_calls_status` 'pending' | 'ready' | 'unavailable' | 'failed'
  - `earnings_calls_error` string, nullable
  - `earnings_call_count` integer
  - `earnings_call_embedded_count` integer
  - `issuer_reports` TickerSourceCoverageOut[]
    - `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)
