---
title: "Retrieves customer reviews for a merchant, specified by reviewId"
method: GET
path: "/v1/merchants/{merchantId}/reviews"
tags: ["merchants"]
---

# Retrieves customer reviews for a merchant, specified by reviewId

`GET /v1/merchants/{merchantId}/reviews`

This endpoint retrieves customer reviews for a particular merchant with rating, description, locale, date & the customer's information.This merchant should be specified by their identifier **merchantId**, which is mandatory.

Supports pagination via offset & limit parameters in the request.

`offset` allows skipping the first n reviews.
`limit` makes sure the response contains a maximum of n reviews.

If not supplied, offset will be 0 and limit will be 10

####Response:

* **customer**: block contains link to customer's profile image, customer's first name & first letter of customer's last name.
* **rating**: a value between 1 and 6, where 1 represents the worst rating and 6 represents the best.
* **description**: the review description entered by the customer.
* **locale**: represents the language settings of the customer, in the format: <language code>_<country code>
* **date**: represents the date of the review, with the format: yyyy-MM-dd

Example curl:
```
curl https://{host}/v{X}/merchants/15/reviews?offset=10&limit=5
```

Example response:
```
{
   reviews: [
     {
           customer: {
                firstName: "Hans",
                lastName: "W",
                profileImage: {
                    url: "https://www..."
                },
           },
           rating: 1,
           description: "Foo bar",                
           locale: "de_DE",
           date: "2017-07-21"
     }
   ],
   offset: 10,
   limit: 5,
   size: 1
}
```

## Path parameters

- `merchantId` integer, required

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Review response

- ReviewDtoList
  - `reviews` ReviewDto[], required — Merchant customer review collection.
    - `customer` CustomerDto, required
      - `firstName` string
      - `lastName` string
      - `profileImage` ImageDto
        - `url` string, url
    - `rating` integer, required — Possible values: 1 to 6.
    - `description` string — The description of the review.
    - `locale` string
    - `date` string, date, required — The date when the review was written.
  - `size` integer
  - `offset` integer
  - `limit` integer

## Other responses

- `400` — Bad request
- `404` — Merchant not found error
- `500` — Internal server error

---

[API](https://skmtc.net/quandoo/apis/quandooapidocumentation.md) · [All operations](https://skmtc.net/quandoo/apis/quandooapidocumentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/quandoo/quandooapidocumentation/revisions/6863a5956792/schema)