---
title: "List accommodation reviews"
method: GET
path: "/demand-api-v2-compatible/reviews"
tags: ["demand-api-v2-compatible"]
---

# List accommodation reviews

`GET /demand-api-v2-compatible/reviews`

Returns reviews for specified hotel_ids and filters. Available filters are country,
language of the review, lower and upper bound of the review score, and timestamp of the last change to the review.
The 'last_change' output field will only be displayed if the last_change=... input parameter is set.

## Query parameters

- `reviewsInputDto` ReviewsInputDto, required
  - `hotel_ids` integer[], required — List of hotel ids for which reviews should be displayed.
  - `language` 'ar' | 'bg' | 'ca' | 'cs' | 'da' | 'de' | 'el' | 'en' | 'en-gb' | 'en-us' | 'es' | 'es-ar' | 'es-mx' | 'et' | 'fi' | 'fr' | 'he' | 'hi' | 'hr' | 'hu' | 'id' | 'is' | 'it' | 'ja' | 'ka' | 'ko' | 'lt' | 'lv' | 'ms' | 'nl' | 'no' | 'pl' | 'pt-br' | 'pt-pt' | 'pt' | 'ro' | 'ru' | 'sk' | 'sl' | 'sr' | 'sv' | 'th' | 'tl' | 'tr' | 'uk' | 'vi' | 'zh' | 'zh-cn' | 'zh-tw' — Limits reviews to those written in this language (default: 'en'). Also sets the language of extras=review_score_word.
  - `country` string — Limits reviews to those written by bookers from the given country. This code is defined by the ISO 3166-1 alpha-2 standard (ISO2) as described here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2.
  - `offset` integer — The number of rows to offset the results by.
  - `rows` integer — The maximum number of rows to return.
  - `last_change` string — Limits the reviews to those changed after the given date in Europe/Amsterdam time zone. Format: 'yyyy-MM-dd HH:mm:ss'.
  - `score_lower_bound` integer — Limits the reviews to those having score greater or equal to this value. Possible values are natural numbers in range [1 - 10].
  - `score_upper_bound` integer — Limits the reviews to those having score lesser or equal to this value. Possible values are natural numbers in range [1 - 10].
  - `extras` 'REVIEW_SCORE_WORD' — Specify here what extra items of the result should be included. See the endpoint description for more detailed information about each extra.

## Response `200`

OK

- ReviewsResponseDto
  - `meta` Meta
    - `ruid` string
  - `result` ReviewOutputDto[]
    - `hotel_id` integer — Id of the reviewed hotel.
    - `average_score` number, double — Average score for this review.
    - `country` string — Reviewer's location represented by a two-letter ISO country code.
    - `headline` string — Headline or summary of the review.
    - `hotel_url` string — URL of the hotel's page on Booking.com.
    - `language` string — Language that the review is in. Please check the "Possible Values" section of the documentation for the supported language codes.
    - `pros` string — Positive comments from this review.
    - `cons` string — Negative comments from this review.
    - `review_id` integer — Unique ID of the review.
    - `date` string — Date of the review in Europe/Amsterdam time zone. Format: 'yyyy-MM-dd HH:mm:ss'.
    - `last_change` string — Date of the last change to the review in Europe/Amsterdam time zone. Returned only if 'last_change' filter is added. Format: 'yyyy-MM-dd HH:mm:ss'.
    - `text_meets_guidelines` boolean — Set to true when review meets the guidelines. The review text will be removed if it doesn't meet guidelines
    - `author` ReviewerOutputDto — Information about the author of this review.
      - `country` string — Two-letter ISO code of the reviewer's country.
      - `name` string — Reviewer's name.
      - `type` string — Reviewer type.
    - `review_score_word` string — Text version of the review score.

## Other responses

- `400` — Invalid input, e.g. a missing, invalid, unknown, or conflicting parameter.
- `500` — An unexpected server error occurred.

---

[API](https://skmtc.net/booking/apis/connect-api.md) · [All operations](https://skmtc.net/booking/apis/connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/booking/connect-api/revisions/0fbdc2f4423a/schema)