Reviews
Published customer reviews, the score summary and the business reply.
Endpoints on this page
Each row links to the full definition in the API reference — fields, response codes and the try-it console.
Listing reviews
curl "https://api.supergelsin.com/api/partner/v1/reviews?limit=20&minRating=4&replyStatus=none" \
-H "Authorization: Basic $(printf '%s:%s' "$API_KEY" "$API_SECRET" | base64)" \
-H "X-Integrator: Ornek POS" \
-H "X-Operator: kasiyer_01"{
"scores": { "average": 4.75, "count": 4, "distribution": { "5": 3, "4": 1, "3": 0, "2": 0, "1": 0 } },
"items": [
{
"id": "cm_ornek_yorum",
"rating": 5,
"title": null,
"comment": "Çok lezzetli",
"verified": true,
"deliveryRating": 4,
"aspectScores": { "taste": 5 },
"reasons": [],
"reply": null,
"createdAt": "2026-01-31T10:00:00.000Z"
}
],
"nextCursor": null
}The list is ordered newest first and paged by cursor. The review text is the version masked by the platform; the customer identity and the raw text are not returned through this surface. scores is computed from all published reviews and is not affected by filters.
Query parameters
| Alan | Tip | Açıklama |
|---|---|---|
limit | integer | Page size, 1–50; default 20. |
minRating | integer | Reviews with this rating or higher (1–5). If omitted there is no rating filter. |
replyStatus | enum | Filters by the state of the business reply: none, pending, approved, rejected. An invalid value returns 400 bad_request. |
cursor | string | The nextCursor from the previous response. |
Review fields
| Alan | Tip | Açıklama |
|---|---|---|
verified | boolean | Whether the reviewer actually placed an order. |
deliveryRating | integer | null | Delivery rating. It is not included in the business score average (scores.average); the average is computed from the rating field. |
aspectScores | object | null | Per-aspect scores. |
reply | object | null | The business's reply (text) and its state (pending, approved, rejected); null if there is none. The reply goes through moderation; the customer sees only an approved reply. |
Replying to a review
curl -X POST "https://api.supergelsin.com/api/partner/v1/reviews/cm_ornek_yorum/reply" \
-H "Authorization: Basic $(printf '%s:%s' "$API_KEY" "$API_SECRET" | base64)" \
-H "X-Integrator: Ornek POS" \
-H "X-Operator: kasiyer_01" \
-H "Content-Type: application/json" \
-d '{ "text": "Geri bildiriminiz için teşekkür ederiz." }'{ "id": "cm_ornek_yorum", "replyStatus": "pending" }The reply goes through moderation (replyStatus: pending). Sending an empty text removes an existing reply; in that case replyStatus is null. A reply is limited to 1000 characters (400 too_long) and can only be added to a published review (409 not_published; current gives the state of the review).
A reply may mention a coupon issued to the customer. A reply that presents the coupon as a reward for the review is not saved and returns
400 coupon_reward_wording: do not tie the coupon to the content or rating of the review, do not make it conditional on editing or deleting the review, and do not promise a coupon in exchange for a review.