Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.

List Reviews

GET

https://api.zid.sa/v1/managers/store/reviews/{type}

Retrieves a list of customer reviews for a specified product within a store. Use this endpoint to fetch all available reviews based on the PRODUCT_ID and STORE_ID.

🔑Scopes

products.read - Products Read

Request

Path Params

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.zid.sa/v1/managers/store/reviews/product?page=1&page_size=3&status=approved&search_term&date_from&date_to&order_by=id&sort_by=DESC' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Accept: application/json' \
--header 'Accept-Language: en'

Responses

🟢200OK

application/json

Body

Examples

SuccessSuccess

{
    "status": "object",
    "pagination": {
        "page": 1,
        "next_page": 2,
        "last_page": 15,
        "result_count": 45
    },
    "reviews": [
        {
            "id": "0423eb5a-3aab-407c-9d00-624bc01970a0",
            "customer": {
                "id": 8878912,
                "name": "Guest"
            },
            "product": {
                "id": "a626fd78-a373-428b-a264-cfcbf7378a13",
                "name": "The Third kit shirt, season 2022/2023",
                "bought_this_item": false,
                "image": null
            },
            "status": "approved",
            "is_anonymous": true,
            "rating": 0,
            "comment": "test",
            "edit_requested": false,
            "original_snapshot": null,
            "reply": null,
            "images": [],
            "created_at": "2023-11-09 09:14:32",
            "updated_at": "2025-06-23 23:06:57"
        },
        {
            "id": "08004cf2-8d35-4b12-8852-97dd6c4a27c9",
            "customer": {
                "id": 179647,
                "name": "test store"
            },
            "product": {
                "id": "cc578c44-2bb4-45bc-969a-579c405fbab1",
                "name": "product with variance  - Cowhide - أبيض - XL",
                "bought_this_item": true,
                "image": null
            },
            "status": "approved",
            "is_anonymous": false,
            "rating": 3,
            "comment": "جميل جدا",
            "edit_requested": false,
            "original_snapshot": null,
            "reply": null,
            "images": [],
            "created_at": "2022-08-28 12:48:21",
            "updated_at": "2025-06-23 23:06:57"
        },
        {
            "id": "0881ad7f-219a-4cef-ab8a-7fd0d3d094f0",
            "customer": {
                "id": 6626507,
                "name": "سلمان ياسر الغامدي"
            },
            "product": {
                "id": "a8ff4987-2b92-45f2-9927-9a905dd1ed04",
                "name": "yazeed test",
                "bought_this_item": false,
                "image": null
            },
            "status": "approved",
            "is_anonymous": false,
            "rating": 5,
            "comment": "rating or smthn",
            "edit_requested": false,
            "original_snapshot": null,
            "reply": null,
            "images": [],
            "created_at": "2023-07-12 13:57:42",
            "updated_at": "2025-06-23 23:06:57"
        }
    ],
    "message": {
        "type": "object",
        "code": null,
        "name": null,
        "description": null
    }
}

🟠401Unauthorized

🔴500Internal Server error

Modified at 2026-02-08 14:36:07

Product Reviews

Count Reviews