Reviews API

Submit a review. The user must have a DELIVERED order containing the product. One review per (user, product). Not shown publicly until admin approves.

Request Body

{
  "order_id": "uuid",        // required — must be a delivered order you placed
  "product_id": "uuid",      // required — product in that order
  "rating": 5,               // required — integer 1–5
  "title": "Amazing quality!", // required
  "body": "Fits perfectly.",  // required
  "images": []               // optional — array of image URLs
}

Response

{ "success": true, "data": { "review": { "id","rating","title","body","is_approved": false } } }

Possible Errors

Edit your own review before it is approved.

Request Body

{ "rating": 4, "title": "Good", "body": "Updated review." }

Response

{ "success": true, "data": { "review": { ... } } }

Possible Errors

Delete your own review.

Response

{ "success": true, "data": null }

List all reviews including unapproved ones.

Response

{ "success": true, "data": { "reviews": [ { "id","rating","title","is_approved","is_featured","user":{"name","email"},"product":{"name"} } ] } }

Approve a review to make it publicly visible.

Response

{ "success": true, "data": { "review": { "id","is_approved": true } } }

Feature a review (highlight on product page).

Response

{ "success": true, "data": { "review": { "id","is_featured": true } } }

Permanently delete a review.

Response

{ "success": true, "data": null }