---
title: "Returns analyst ratings consensus data"
method: GET
path: "/api/v1/consensus-ratings"
tags: ["consensus_ratings"]
---

# Returns analyst ratings consensus data

`GET /api/v1/consensus-ratings`

Returns aggregated consensus analyst ratings data for a given ticker symbol. This endpoint provides consensus price targets, aggregate ratings distribution, and analyst counts based on recent analyst ratings.

## Query parameters

- `pagesize` integer
- `parameters[date_from]` string, YYYY-MM-DD
- `parameters[date_to]` string, YYYY-MM-DD
- `parameters[tickers]` string
- `simplify` boolean
- `aggregate_type` 'number' | 'percentage'

## Headers

- `accept` 'application/json', required

## Response `200`

success

- GitlabBenzingaIoBenzingaBzgoPkgModelsCalendarApiConsensusRating
  - `aggregate_ratings` GitlabBenzingaIoBenzingaBzgoPkgModelsCalendarApiAggregateRating
    - `buy` integer
    - `hold` integer
    - `sell` integer
    - `strong_buy` integer
    - `strong_sell` integer
  - `aggregate_type` string
  - `consensus_price_target` number
  - `consensus_rating` string
  - `consensus_rating_val` number
  - `high_price_target` number
  - `low_price_target` number
  - `total_analyst_count` integer
  - `unique_analyst_count` integer
  - `updated_at` string

## Other responses

- `204` — No Content
- `400` — Bad Request
- `500` — Internal Error

---

[API](https://skmtc.dev/benzinga/apis/data-api-proxy.md) · [All operations](https://skmtc.dev/benzinga/apis/data-api-proxy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/benzinga/data-api-proxy/revisions/ea334a9e2e05/schema)