Get Reviews

Gets the current and previous reviews for a store. Requires the stores.view permission.

GET /stores/{storeId}/reviews

Get reviews

cURL

curl --request GET \
  --url https://api.komerza.com/stores/{storeId}/reviews \
  --header 'Authorization: Bearer <token>'

200

{
  "success": true,
  "pages": 123,
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "dateCreated": "2023-11-07T05:31:56Z",
      "rating": 123,
      "reason": "<string>",
      "productName": "<string>",
      "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "customerEmail": "<string>",
      "reply": "<string>",
      "repliedAt": "2023-11-07T05:31:56Z",
      "repliedByUserId": "<string>",
      "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "flagged": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "dateCreated": "2023-11-07T05:31:56Z",
        "reason": "<string>",
        "approved": true,
        "administratorNote": "<string>"
      }
    }
  ]
}

Filterable Fields

This endpoint supports filtering and sorting. See the Filtering & Sorting Guide for syntax details.

Field	Type	Description
rating	integer	Filter by star rating (1-5)
emailAddress	string	Filter by customer email (case-insensitive contains)
hasReply	boolean	Filter reviews that have a merchant reply
dateRangeFrom	datetime	Filter reviews created on or after this date
dateRangeTo	datetime	Filter reviews created on or before this date

Example:

# 5-star reviews from last 30 days
GET /api/stores/{storeId}/reviews?filters=rating==5,dateRangeFrom>=2025-10-28

# Reviews without replies, sorted by newest first
GET /api/stores/{storeId}/reviews?filters=hasReply==false&sorts=-dateRangeFrom

Authorizations

Authorization · string · header · required

Your API key goes here

Path Parameters

storeId · string<uuid> · required

The ID of the store to get the reviews for

Query Parameters

rating · integer<int32>

Filter by star rating (exact match).

emailAddress · string

Case-insensitive contains on the customer’s email address.

hasReply · boolean

Only reviews that have a merchant reply.

dateRangeFrom · string<date-time>

Reviews created on or after this date.

dateRangeTo · string<date-time>

Reviews created on or before this date.

Filters · string

Sorts · string

Page · integer<int32>

Required range: 1 <= x <= 2147483647

PageSize · integer<int32>

Required range: 1 <= x <= 2147483647

Response

200

text/plain

The object was successfully returned.

Represents a paginated response returned from API endpoints, which contains the paginated data and metadata about the pagination.

success · boolean · required · read-only

Indicates whether the operation was successful

pages · integer<int32> · required

The total number of pages available in the paginated response.

data · object[] · required

Represents the collection of items within a paginated response

Show child attributes