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

# Get Expectations Research

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

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

## Path parameters

- `ticker` string, required

## Response `200`

Successful Response

- ExpectationsResearchOut
  - `ticker` string, required
  - `provider` string, required
  - `provider_url` string, required
  - `license_status` 'enabled' | 'licensing_required', required
  - `coverage` ResearchCoverageOut[], required
    - `dataset` 'consensus' | 'earnings_results' | 'earnings_calendar' | 'ir_presentations', required
    - `status` 'ready' | 'stale' | 'unavailable' | 'failed' | 'not_refreshed' | 'licensing_required', required
    - `detail` string, nullable, required
    - `last_attempted_at` string, date-time, nullable, required
    - `last_success_at` string, date-time, nullable, required
    - `record_count` integer
    - `metric_count` integer
    - `period_count` integer
    - `earliest_period_end` string, date, nullable
    - `latest_period_end` string, date, nullable
    - `freshness_sla_hours` integer, nullable
    - `freshness_lag_hours` number, nullable
  - `consensus` ConsensusEstimateOut[], required
    - `metric` 'eps' | 'revenue' | 'ebitda' | 'gross_margin' | 'operating_margin', required
    - `period_type` 'quarterly' | 'annual', required
    - `fiscal_period_end` string, date, required
    - `fiscal_year` integer, nullable, required
    - `fiscal_quarter` integer, nullable, required
    - `fiscal_period_mapping_source` string, required
    - `fiscal_period_mapping_is_estimated` boolean, required
    - `average` number, nullable, required
    - `high` number, nullable, required
    - `low` number, nullable, required
    - `analyst_count` integer, nullable, required
    - `unit` string, required
    - `currency` string, nullable, required
    - `revision_7d_pct` number, nullable, required
    - `revision_30d_pct` number, nullable, required
    - `revision_60d_pct` number, nullable, required
    - `revision_90d_pct` number, nullable, required
    - `observed_at` string, date-time, required
  - `earnings_history` EarningsResultOut[], required
    - `fiscal_period_end` string, date, required
    - `fiscal_year` integer, nullable, required
    - `fiscal_quarter` integer, nullable, required
    - `actual_eps` number, nullable, required
    - `consensus_eps` number, nullable, required
    - `surprise_abs` number, nullable, required
    - `surprise_pct` number, nullable, required
    - `metric` string
    - `actual_value` number, nullable
    - `as_of_consensus` number, nullable
    - `surprise_sign` 'beat' | 'miss' | 'in_line' | 'not_calculable'
    - `surprise_basis` 'tickertrac_as_of_consensus' | 'provider_reported_consensus' | 'legacy_provider_reported' | 'unavailable'
    - `unit` string
    - `currency` string, nullable
    - `provider` string, required
    - `source_url` string, required
    - `published_at` string, date-time, nullable
    - `consensus_observed_at` string, date-time, nullable
    - `fiscal_period_mapping_source` string
    - `fiscal_period_mapping_is_estimated` boolean
    - `observed_at` string, date-time, required
  - `earnings_calendar` EarningsEventOut[], required
    - `event_date` string, date, required
    - `timing` 'bmo' | 'amc' | 'dmh' | 'unknown', required
    - `date_status` 'confirmed' | 'estimated' | 'provider_scheduled', required
    - `scheduled_at` string, date-time, nullable
    - `event_timezone` string
    - `status_source` string
    - `fiscal_year` integer, nullable, required
    - `fiscal_quarter` integer, nullable, required
    - `fiscal_period_end` string, date, nullable, required
    - `eps_estimate` number, nullable, required
    - `revenue_estimate` number, nullable, required
    - `source_url` string, required
    - `history` EarningsEventHistoryOut[]
      - `event_date` string, date, required
      - `scheduled_at` string, date-time, nullable, required
      - `timing` 'bmo' | 'amc' | 'dmh' | 'unknown', required
      - `date_status` 'confirmed' | 'estimated' | 'provider_scheduled', required
      - `event_timezone` string, required
      - `status_source` string, required
      - `observed_at` string, date-time, required
      - `superseded_at` string, date-time, nullable, required
      - `change_kind` 'initial' | 'date_changed' | 'status_changed' | 'time_changed', required
    - `observed_at` string, date-time, 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)