---
title: "Product/seller reviews"
---

# Product reviews

Each customer is able to create a review about the product. The review object consists of integer rating value (1-5) and optional text comment (up to 300 characters). The average rating can be calculated in order to display on the product page. The customer can also list all the reviews he created.

### Example - Customer creates product review

```
POST /api/store/reviews
{
   "order_id": "ord_xxx",
   "reference": "product",
   "reference_id": "prod_xxx",
   "rating": 5,
   "customer_note": "Very good product"
}
```

### Example - List reviews

```
GET /api/store/reviews?offset=0&limit=50
```

# Seller reviews

Similarly to product reviews, customer can also create a review on the sellers. This type of review also includes integer rating value and comment.

Seller can respond to the review, or escalate to marketplace administrator, if he thinks that the review is against the rules or unfair.

### Example - Customer creates seller review

```
POST /api/store/reviews
{
   "order_id": "ord_xxx",
   "reference": "seller",
   "reference_id": "sel_xxx",
   "rating": 2,
   "customer_note": "Not very good seller"
}
```

### Example - Seller responds to the review

```
POST /api/vendor/sellers/me/reviews/rev_xxx
{
   "seller_note": "We are very sorry about your inconvenience"
}
```

### Escalating reviews

Seller can request to delete the review using `requests`. After submitting the request the marketplace administrator makes the decision to delete the review or not.

```
POST /api/vendor/requests
{
   "request": {
      "type": "review_remove",
      "data": {
         "review_id": "rev_xxx",
         "reason": "I consider this review unfair"
      }
   }
}
```

```mermaid
flowchart LR

id1(Seller creates a request)
id2[(Request saved in the DB)]
id3{Admin reviews request}
id4a(Approved)
id4b(Rejected)
id5a(Review is deleted)
id5b(Admin note is created)
id6(Notification is sent)

id1-->id2
id2-->id3
id3-->id4a
id3-->id4b
id4a-->id5a
id4b-->id5b
id5a-.->id6
id5b-.->id6;

```