---
title: "Analyst ratings snapshot"
method: GET
path: "/analyst_ratings/light"
tags: ["analysis"]
---

# Analyst ratings snapshot

`GET /analyst_ratings/light`

The analyst ratings snapshot endpoint provides a streamlined summary of ratings from analyst firms for both US and international markets. It delivers essential data on analyst recommendations, including buy, hold, and sell ratings, allowing users to quickly assess the general sentiment of analysts towards a particular stock.

## Query parameters

- `symbol` string
- `figi` string
- `isin` string
- `cusip` string
- `exchange` string
- `mic_code` string
- `rating_change` 'Maintains' | 'Upgrade' | 'Downgrade' | 'Initiates' | 'Reiterates'
- `outputsize` integer
- `country` string

## Response `200`

- object
  - `meta` object, required — Meta information about the instrument
    - `symbol` string, required — Symbol ticker of the instrument
    - `name` string, required — Name of the instrument
    - `currency` string, required — Currency in which the instrument is traded
    - `exchange_timezone` string, required — Timezone of the exchange
    - `exchange` string, required — Exchange where the instrument is traded
    - `mic_code` string, required — Market identifier code (MIC) under ISO 10383 standard
    - `type` string, required — Type of the instrument
  - `ratings` object[] — List of analyst ratings
    - `date` string, required — Date when the rating was released
    - `firm` string, required — Firm that issued the ranking
    - `rating_change` string — Defines the action of the firm to ranking, could be `Maintains`, `Upgrade`, `Downgrade`, `Initiates` or `Reiterates`
    - `rating_current` string — Current firm's ranking of the instrument
    - `rating_prior` string — Prior firm's ranking of the instrument
  - `status` string, required — Response status

## Other responses

- `400`
- `401`
- `403`
- `404`
- `414`
- `429`
- `500`

---

[API](https://skmtc.net/twelvedata/apis/twelve-data-api.md) · [All operations](https://skmtc.net/twelvedata/apis/twelve-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twelvedata/twelve-data-api/revisions/c4a12725cdb5/schema)