---
title: "List reviews for a product"
method: GET
path: "/products/{productId}/reviews"
tags: ["Product"]
---

# List reviews for a product

`GET /products/{productId}/reviews`

## Request

- Base URL: `http://localhost:8000/api/shop`
- URL: `http://localhost:8000/api/shop/products/{productId}/reviews`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bagisto/apis/bagisto-shop-api/docs/products/:productId/reviews/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns reviews scoped to the given product ID. Defaults to `approved` reviews only; pass `status` to override. Supports filtering by `status` and `rating`, with `page` + `per_page` (alias `limit`, max 50) pagination.

## Path parameters

- `productId` string, required

## Query parameters

- `rating` integer
- `page` integer
- `per_page` integer

## Headers

- `X-STOREFRONT-KEY` string, required
- `X-Locale` string
- `X-Channel` string
- `X-Currency` string

## Response `200`

List of reviews for the product.

## Changes

- **2026-10-28** `b84d43839844`: 1 warning
  - deleted the `query` request parameter `status`

[Operation history](https://skmtc.dev/bagisto/apis/bagisto-shop-api/changes/products/:productId/reviews/get.md)

---

[API](https://skmtc.dev/bagisto/apis/bagisto-shop-api.md) - [All operations](https://skmtc.dev/bagisto/apis/bagisto-shop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bagisto/apis/bagisto-shop-api/revisions/f619df36bf29?raw)