---
title: "Query Reviews"
method: GET
path: "/reviews"
tags: ["Reviews"]
---

# Query Reviews

`GET /reviews`

Query reviews like the [Reviews Page](https://hostex.io/app/reviews).

## Query parameters

- `reservation_code` string
- `property_id` integer
- `review_status` 'pending_guest_review' | 'pending_host_review' | 'reviewed'
- `start_check_out_date` string, date
- `end_check_out_date` string, date
- `offset` integer, required
- `limit` integer, required

## Response `200`

- object
  - `request_id` string, required — Unique identifier for the request.
  - `error_code` integer, required — Numeric error code representing the status of the response. A value of `200` indicates success. <br> See the [Error Codes](/reference/error-manual#error-codes) section for more information.
  - `error_msg` string, required — Message detailing the status of the response.
  - `data` object, required
    - `reviews` object[], required — List of the reviews
      - `reservation_code` string, required — The unique code identifying the reservation.
      - `property_id` integer, required — The id of the property the reservation is associated with.
      - `channel_type` 'airbnb' | 'booking.com' | 'agoda' | 'expedia' | 'vrbo' | 'trip.com' | 'booking_site' | 'tujia_intl' | 'hostex_direct' | 'tujia' | 'xiaozhu' | 'meituan_bnb' | 'meituan_hotel' | 'muniao' | 'fliggy' | 'zhukeyun' | 'tiktok' | 'xiaohongshu' | 'ctrip' | 'houfy', required — The type of the channel. See [Supported Channels](/reference/supported-channels) for more information.
      - `listing_id` string, required — The unique identifier for different channels. <br>For example, the listing id for Airbnb is the Airbnb listing id, and the listing id for Booking.com is the Booking.com room id - rateplan id.
      - `check_in_date` string, date, required — The check-in date of the reservation.
      - `check_out_date` string, date, required — The check-out date of the reservation.
      - `host_review` object, nullable — Reviews made by the host about the guest. Return `null` if the host has not made a review yet.
        - `score` number — The rating score of the host review. The value is between 0 and 5.
        - `sub_score` object[], nullable — Category-level sub-scores for the host review. Only available for Airbnb channels. Returns `null` if not available. Rating is on a scale of 1–5.
          - `category` string — The name of the rating category. Example: `accuracy`, `checkin`, `cleanliness`, `communication`, `location`, `value`.
          - `rating` number — The rating score for the category. The value is between 1 and 5.
          - `review_category_tags` string[], nullable — Structured tags associated with the category rating.
        - `content` string — The comment of the host.
        - `created_at` string, date-time — The datetime when the host review was created in ISO 8601 format. Example: `2019-01-01T00:00:00+00:00`
      - `guest_review` object, nullable — Reviews made by the guest about their stay. Return `null` if the guest has not made a review yet.
        - `score` number — The rating score of the guest review. The value is between 0 and 5.
        - `sub_score` object[], nullable — Category-level sub-scores for the guest review. Available for Airbnb and Booking.com channels. Returns `null` if not available. Rating scale differs by channel: 1–5 for Airbnb, 1–10 for Booking.com.
          - `category` string — The name of the rating category. Airbnb example: `accuracy`, `checkin`, `cleanliness`, `communication`, `location`, `value`. Booking.com example: `facilities`, `comfort`, `staff`, `value`, `clean`, `location`.
          - `rating` number — The rating score for the category. Between 1 and 5 for Airbnb, between 1 and 10 for Booking.com.
          - `review_category_tags` string[], nullable — Structured tags associated with the category rating. Only present for Airbnb channels.
        - `content` string — The comment of the guest.
        - `created_at` string, date-time — The datetime when the guest review was created in ISO 8601 format. Example: `2019-01-01T00:00:00+00:00`
      - `host_reply` object, nullable — The host's reply to the guest's review. Return `null` if the host has not made a reply yet.
        - `content` string — The reply of the host.
        - `created_at` string, date-time — The datetime when the reply was created in ISO 8601 format. Example: `2019-01-01T00:00:00+00:00`

---

[API](https://skmtc.net/hostex/apis/hostex-api.md) · [All operations](https://skmtc.net/hostex/apis/hostex-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hostex/hostex-api/versions/a3fa555dee66/schema)