---
title: "Get Scores"
method: GET
path: "/scores"
tags: ["Lookup"]
---

# Get Scores

`GET /scores`

## Request

- Base URL: `https://api.morningconsult.com/v1`
- URL: `https://api.morningconsult.com/v1/scores`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/morningconsult/apis/morning-consult-api/docs/scores/get.ts> (a function with typed inputs; its response is checked against the schema)

Search scores (e.g., Net Favorability, NPS, ICS) across the data sources you have access to. Supply the optional `data_source_id` parameter to restrict results to a specific data source.
Scores are universal: a given score ID is applicable to any data source where it can be calculated. To discover which data sources a score is valid in, use the [/scores/{score_id}/data_sources](#GET-getScoreDataSources) endpoint.

## Query parameters

- `data_source_id` string, uuid
- `country_code` string: Two letter [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code. This can be used in the `country_code` query parameter of multiple endpoints to limit results to the specific country.
- `query` string
- `page_size` integer
- `pagination_token` string, base64: A pagination token to use to get paginated results. For more details, see the section on [Pagination](#pagination).

## Response `200`

Scores

- object
  - `scores` Score[]: A list of countries the score is valid in.
    - `id` string, uuid: The unique identifier for a score.
    - `label` string: A short label describing the score.
    - `description` string: A description of the score.
    - `entity_type` EntityType: A entity type, such as brand or favorability.
      - `id` string: The ID of the entity type, which can be used for filtering entities.
      - `label` string: The descriptive label of the entity type.
    - `components` object[]: The components available for this score. Scores such as "Price Surprise" and "Unavailability" expose components that restrict the calculation to a subset of categories (for example "home_appliances"). If this field is present, at least one component ID must be provided in `component_ids` when running the score.
      - `id` string, required: The unique identifier for the component.
  - `pagination_token` string, base64: A pagination token to use to get paginated results. For more details, see the section on [Pagination](#pagination).

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

[API](https://skmtc.dev/morningconsult/apis/morning-consult-api.md) - [All operations](https://skmtc.dev/morningconsult/apis/morning-consult-api/llms.txt) - [OpenAPI document](https://skmtc.dev/morningconsult/apis/morning-consult-api/revisions/70d621a9c59c?raw)