---
title: "Get list of reviews"
method: GET
path: "/reviews-and-ratings/api/reviews"
tags: ["Review"]
---

# Get list of reviews

`GET /reviews-and-ratings/api/reviews`

## Request

- Base URL: `https://storecomponents.myvtex.com`
- URL: `https://storecomponents.myvtex.com/reviews-and-ratings/api/reviews`
- Auth: one of:
  - API key in header `X-VTEX-API-AppKey` and API key in header `X-VTEX-API-AppToken`
  - API key in header `VtexIdclientAutCookie`

Retrieves a list of reviews related to a product.
## Permissions

This endpoint does not require [permissions](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3).

## Query parameters

- `search_term` string
- `from` string
- `to` string
- `order_by` string
- `status` boolean
- `product_id` string

## Headers

- `Content-Type` string, required
- `Accept` string, required

## Response `200`

OK

- object: Response body object.
  - `data` object[]: Array of reviews.
    - `id` string: Review ID.
    - `productId` string: Product ID.
    - `rating` number: Customer rating.
    - `title` string: Review's title.
    - `text` string: Review's text.
    - `reviewerName` string: Reviewer name.
    - `shopperId` string: Shopper email.
    - `reviewDateTime` string: Review's date and time.
    - `searchDate` string: Review's search date.
    - `verifiedPurchaser` boolean: Indicates if the reviewer is a verified purchaser (`true`) or not (`false`).
    - `sku` string, nullable: SKU ID.
    - `approved` boolean: Indicates if the review was approved (`true`) or not (`false`).
    - `location` string, nullable: Review's origin location.
    - `locale` string, nullable: Review's locale.
    - `pastReviews` string, nullable: Past reviews of the same product.
  - `range` object: Range of the reviews list.
    - `total` number: Total number of reviews on the list.
    - `from` number: Zero base starting record number.
    - `to` number: Zero base ending record number.

## Changes

- **2025-12-15** `9d648339bf09`: 6 info
  - the `query` request parameter `from` became optional
  - the `query` request parameter `order_by` became optional
  - the `query` request parameter `product_id` became optional
  - the `query` request parameter `search_term` became optional
  - …2 more
- **2023-12-21** `7a18272398d1`: 1 info
  - endpoint added
- **2023-12-21** `34c8ffbc87a1`: 1 breaking
  - api removed without deprecation
- **2023-12-21** `7a18272398d1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vtex/apis/reviews-and-ratings-api/changes/reviews-and-ratings/api/reviews/get.md)

---

[API](https://skmtc.dev/vtex/apis/reviews-and-ratings-api.md) - [All operations](https://skmtc.dev/vtex/apis/reviews-and-ratings-api/llms.txt) - [OpenAPI document](https://skmtc.dev/vtex/apis/reviews-and-ratings-api/revisions/b3004f2e6a88?raw)