Skip to main content
GET
/
stores
/
{storeId}
/
reviews
Get reviews
curl --request GET \
  --url https://api.komerza.com/stores/{storeId}/reviews \
  --header 'Authorization: Bearer <token>'
{
  "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.
FieldTypeDescription
ratingintegerFilter by star rating (1-5)
emailAddressstringFilter by customer email (case-insensitive contains)
hasReplybooleanFilter reviews that have a merchant reply
dateRangeFromdatetimeFilter reviews created on or after this date
dateRangeTodatetimeFilter 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

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

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