> ## Documentation Index
> Fetch the complete documentation index at: https://docs.salesive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get shop reviews

> Retrieve all reviews for the shop.

## Request

```http theme={null}
GET /reviews?page=1&limit=10
x-shop-id: {{shopId}}
```

## Headers

| Header      | Type   | Description        |
| ----------- | ------ | ------------------ |
| `x-shop-id` | string | Identify the shop. |

## Query parameters

| Parameter | Type    | Description                     |
| --------- | ------- | ------------------------------- |
| `page`    | integer | Page number (default: 1).       |
| `limit`   | integer | Reviews per page (default: 10). |

## Successful response

```json theme={null}
{
    "status": 200,
    "success": true,
    "message": "Shop reviews retrieved successfully",
    "data": {
        "reviews": [
            {
                "_id": "6a27d8d4289b87893fcbdeca",
                "rating": 5,
                "title": "Great Product",
                "comment": "I loved this product, it was amazing!",
                "shop": "68b8f52575da81b332af29f1",
                "user": {
                    "_id": "69360693a7a8f7dc8ae32d6d",
                    "name": "Jane Smith",
                    "avatar": "https://cdn.salesive.com/avatars/jane.jpg"
                },
                "product": null,
                "order": "6938414ad9485f4d96134f8c",
                "images": [],
                "createdAt": "2026-06-09T09:11:48.272Z",
                "updatedAt": "2026-06-09T09:11:48.272Z",
                "__v": 0
            }
        ],
        "total": 1,
        "page": 1,
        "totalPages": 1
    }
}
```

## Empty response

```json theme={null}
{
    "status": 200,
    "success": true,
    "message": "Shop reviews retrieved successfully",
    "data": {
        "reviews": [],
        "total": 0,
        "page": 1,
        "totalPages": 0
    }
}
```


## OpenAPI

````yaml GET /reviews
openapi: 3.1.0
info:
  title: Salesive Store API
  description: >-
    REST interface for querying products, categories, and merchandising banners
    exposed by Salesive storefronts.
  version: 1.0.0
servers:
  - description: Production
    url: https://store.salesive.com/api/v1
security:
  - BearerAuth: []
    ShopIdHeader: []
paths:
  /reviews:
    get:
      summary: Get shop reviews
      description: Retrieve all reviews for the shop.
      parameters:
        - $ref: '#/components/parameters/XShopIdHeader'
        - name: page
          in: query
          schema:
            type: integer
            default: 1
        - name: limit
          in: query
          schema:
            type: integer
            default: 10
      responses:
        '200':
          description: Reviews retrieved
components:
  parameters:
    XShopIdHeader:
      name: x-shop-id
      in: header
      description: >-
        Optional identifier that scopes responses to a specific storefront when
        the referer cannot be inferred.
      required: false
      schema:
        type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT issued by the Salesive Store API for authenticated shoppers.
    ShopIdHeader:
      type: apiKey
      in: header
      name: x-shop-id
      description: >-
        Optional storefront identifier sent as a header to scope responses to a
        specific shop. Try It requests remember this value once provided.

````