Skip to main content

shop.reviews.list(productId, limit?)

Returns approved reviews for a product, ordered by newest first.

Parameters

ParamTypeDefaultDescription
productIdstringThe product’s UUID
limitnumber50Max reviews to return (max 100)

Response

Example — Review list with star rating


shop.reviews.submit(params)

Submits a new review for a product. Reviews require seller approval before appearing publicly.

Parameters

ParamTypeRequiredDescription
product_idstringUUID of the product being reviewed
ratingnumberInteger between 1 and 5
review_textstringWritten review
customer_namestringReviewer’s name
customer_emailstringReviewer’s email
image_urlstringURL of an attached image

Response

Example — Review submission form

Submitted reviews are not immediately visible. They require manual approval from the shop owner in their seller dashboard.