---
title: "Read verified analyst consensus, including company, product, segment and operating forecasts with original units and publication dates. Values and period labels retain the source's units and accounting basis. Reading never runs a scraper."
method: GET
path: "/v1/stocks/{ticker}/analyst-estimates"
tags: ["AnalystEstimates"]
---

# Read verified analyst consensus, including company, product, segment and operating forecasts with original units and publication dates. Values and period labels retain the source's units and accounting basis. Reading never runs a scraper.

`GET /v1/stocks/{ticker}/analyst-estimates`

## Request

- Base URL: `https://api.equibles.com`
- URL: `https://api.equibles.com/v1/stocks/{ticker}/analyst-estimates`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/equibles/apis/equibles-api/docs/v1/stocks/:ticker/analyst-estimates/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `ticker` string, required

## Query parameters

- `metric` string
- `period` string
- `dimensions` string
- `snapshotId` string, uuid
- `asOf` string, date-time
- `snapshotOffset` integer
- `limit` integer
- `offset` integer

## Response `200`

OK

- AnalystEstimatesResponse
  - `ticker` string, nullable
  - `companyName` string, nullable
  - `status` string, nullable
  - `provider` string, nullable
  - `coverageNote` string, nullable
  - `stale` boolean
  - `newerSnapshotPending` boolean
  - `snapshotId` string, uuid, nullable
  - `capturedAt` string, date-time, nullable
  - `verifiedAt` string, date-time, nullable
  - `lastCheckedAt` string, date-time, nullable
  - `publicationLabel` string, nullable
  - `snapshots` AnalystEstimateSnapshotViewModel[], nullable
    - `id` string, uuid
    - `capturedAt` string, date-time
    - `publicationLabel` string, nullable
  - `data` AnalystEstimateResponseRow[], nullable
    - `publicationLabel` string, nullable
    - `metric` string, nullable
    - `period` string, nullable
    - `dimensions` string, nullable
    - `unit` string, nullable
    - `basis` string, nullable
    - `statistic` string, nullable
    - `analyst` string, nullable
    - `value` string, nullable
    - `footnotes` string, nullable
  - `snapshotsMeta` PageMeta
    - `limit` integer
    - `offset` integer
    - `count` integer
    - `hasMore` boolean
    - `total` integer, nullable
  - `meta` PageMeta
    - `limit` integer
    - `offset` integer
    - `count` integer
    - `hasMore` boolean
    - `total` integer, nullable

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/equibles/apis/equibles-api.md) - [All operations](https://skmtc.dev/equibles/apis/equibles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equibles/apis/equibles-api/revisions/666e06778588?raw)