---
title: "GET /products/reviews"
method: GET
path: "/products/reviews"
tags: ["Products"]
---

# GET /products/reviews

`GET /products/reviews`

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Successful response

- GetExternalProductReviewsResponseV2 — Response containing product reviews for a brand.
  - `product_reviews_with_details` ExternalProductReviewWithDetailsV2[]
    - `product_review` ExternalProductReviewV2 — Core product review data.
      - `id` string
      - `rating` integer
      - `comment` string
      - `brand_order_id` string
      - `created_at` string — An ISO 8601 extended timestamp of when the review was created.
      - `updated_at` string — An ISO 8601 extended timestamp of when the review was last updated.
      - `published_at` string — An ISO 8601 extended timestamp of when the review was published.
      - `images` ExternalImageV2[]
        - `id` string — Read-only. The unique identifier of the image, beginning with "i_".
        - `width` integer — Read-only. The width of the image in pixels.
        - `height` integer — Read-only. The height of the image in pixels.
        - `sequence` integer — The ordering to display the image when it is part of a collection of images.
        - `url` string — The URL for the image file. When provided as an input, Faire will attempt to download the image and host it on the Faire CDN. If it fails to download, Faire will attempt to serve the original image URL.
        - `original_url` string — [READ-ONLY] The original url passed in for this image.
        - `tags` string[] — TODO: Document. What are tags? Are they an input?
      - `reply` ExternalProductReviewReplyV2 — A brand's reply to a product review.
        - `comment` string
        - `created_at` string — An ISO 8601 extended timestamp of when the reply was created.
    - `retailer_id` string
    - `product_info` ExternalProductInfoV2
      - `product_id` string
      - `name` string
  - `limit` integer — The number of items per page.
  - `cursor` string — Cursor for cursor-based pagination. Use this for efficient pagination of large result sets. Null when no more pages available.

## Other responses

- `400` — Bad Request -- Your request is invalid.
- `401` — Unauthorized -- Your API key is wrong.
- `404` — Not found -- The requested resource could not be found.
- `405` — Method Not Allowed -- You tried to access an entity with an invalid method.
- `429` — Too Many Requests.
- `500` — Internal Server Error -- We had a problem with our server. Try again later.
- `503` — Service Unavailable -- We're temporarily offline for maintenance. Please try again later.

---

[API](https://skmtc.net/faire/apis/faire-external-api.md) · [All operations](https://skmtc.net/faire/apis/faire-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/faire/faire-external-api/revisions/19558399745c/schema)