---
title: "Returns analyst ratings data"
method: GET
path: "/api/v2.1/calendar/ratings"
tags: ["ratings"]
---

# Returns analyst ratings data

`GET /api/v2.1/calendar/ratings`

Returns analyst ratings data including upgrades, downgrades, initiations, and price target changes from Wall Street analysts. Includes current and prior ratings, price targets, analyst information, and ratings accuracy metrics when available.

## Query parameters

- `fields` string, csv
- `page` integer
- `pagesize` integer
- `parameters[date]` string, YYYY-MM-DD
- `parameters[date_from]` string, YYYY-MM-DD
- `parameters[date_to]` string, YYYY-MM-DD
- `parameters[importance]` 0 | 1 | 2 | 3 | 4 | 5
- `parameters[tickers]` string, csv
- `parameters[updated]` integer
- `parameters[analyst_id]` string, csv
- `parameters[firm_id]` string, csv
- `parameters[action]` 'Downgrades' | 'Maintains' | 'Reinstates' | 'Reiterates' | 'Upgrades' | 'Assumes' | 'Initiates Coverage On' | 'Terminates Coverage On' | 'Removes' | 'Suspends' | 'Firm Dissolved'
- `analyst` string, csv
- `firm` string, csv
- `simplify` boolean

## Headers

- `accept` 'application/json', required

## Response `200`

success

- ApiRatingResponse — API response containing an array of analyst ratings
  - `ratings` GitlabBenzingaIoBenzingaBzgoPkgModelsCalendarApiRating[]
    - `action_company` string
    - `action_pt` string
    - `adjusted_pt_current` string
    - `adjusted_pt_prior` string
    - `analyst` string
    - `analyst_id` string
    - `analyst_name` string
    - `currency` string
    - `cusip` string
    - `date` string
    - `exchange` string
    - `firm_id` string
    - `id` string
    - `importance` integer
    - `isin` string
    - `name` string
    - `notes` string
    - `pt_current` string
    - `pt_prior` string
    - `rating_current` string
    - `rating_prior` string
    - `ticker` string
    - `time` string — Time of the rating announcement (EST)
    - `updated` integer
    - `url` string
    - `url_calendar` string
    - `url_news` string

## Other responses

- `400` — Bad Request
- `500` — Internal Server 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)