Developer docs
Which API?
New: Application API docs
Pick the API you are reading here — the Merchant API for your own store, the Application API for partner apps.
Developer docs
New: Application API docs
Pick the API you are reading here — the Merchant API for your own store, the Application API for partner apps.
Everything you need to integrate with the Gini v2 Third-Party API.
Read the reviews customers left on your orders and products — the same set that feeds your public rating. Read-only.
Every review of your orders and products, newest first. Paginated.
/api/v2.0/third-party/reviews
| Field | Type | Required | Description |
|---|---|---|---|
search
|
string | Optional | Match the comment, delivery comment, or customer name/phone. |
rating
|
string | Optional | low (1–3 stars) or high (4–5 stars). |
subject
|
string | Optional | order or product. |
per_page
|
integer | Optional | 1–100, default 15. |
{
"data": [
{
"id": 88,
"rating": 5,
"comment": "Fast delivery",
"reasons": null,
"delivery_rating": 5,
"delivery_comment": null,
"created_at": "2026-09-07T10:00:00.000000Z",
"customer": {
"id": 501,
"name": "Ahmed",
"contact_phone": "07701234567"
},
"subject": {
"type": "product",
"id": 101,
"name": "Headphones",
"slug": "headphones"
}
}
],
"links": [],
"meta": []
}A single review by its numeric id.
/api/v2.0/third-party/reviews/{review}