Skip to main content
GET
Get Product Reviews
GET {BASE_URL}/products/{productId}/reviews

Query parameters

integer
Default 20.
string
newest · oldest · highest · lowest · helpful
string
approved (default). Other statuses require admin auth. See All reviews (admin).
string
positive · neutral · negative — Growth/Enterprise only.
integer
Page number.

Response

attributes is always present on each review. Reviews without custom attributes return {}.

Headers

X-Merchant-Id
string
Origin
string

Path Parameters

productId
string
required

Query Parameters

merchantId
string
limit
integer

Number of reviews to return

sort
string

Sort order: newest, oldest, highest, lowest, helpful

status
string

Filter by status: approved, pending, rejected, flagged, all

page
integer

Page number for pagination

Response

Successful response

reviews
object[]
required
totalReviews
integer
required
Example:

148

averageRating
number
required
Example:

4.7

ratingDistribution
object
required
Example:
hasMore
boolean
required
Example:

true

lastVisible
string | null
Example:

"rev_abc123"