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

# Retrieve reviews

`GET /api/reviews`

Get reviews list by parameters

## Query parameters

- `skip` integer
- `limit` integer
- `channelId` 'airbnb2' | 'bookingCom'
- `listingId` string
- `reservationId` string
- `externalReservationId` string
- `externalReviewId` string
- `startDate` string
- `endDate` string, date-time

## Response `200`

successful operation

- object
  - `limit` number, required
  - `skip` number, required
  - `data` object[], required
    - `_id` string, required — id of Guesty review
    - `accountId` string, required — id of Guesty account
    - `externalReviewId` string, required — id of review in channel
    - `channelId` 'bookingCom' | 'airbnb2', required — channel id
    - `subListingId` string — id of Guesty MU child listing in case related reservation is assigned to it
    - `listingId` string, required — id of Guesty listing that integrated with channel or related reservation is assigned to
    - `complexId` string — id of Guesty complex if listing integrated with channel is assigned to
    - `externalListingId` string, required — id of airbnb listing or booking.com room to which review belong to
    - `externalComplexId` string — id of hotel for booking.com, empty for airbnb
    - `reservationId` string — id of Guesty reservation linked to review
    - `externalReservationId` string, required — id of linked reservation in channel
    - `guestId` string — id of guest in Guesty
    - `createdAt` string, date-time, required — date-time of creation in channel
    - `updatedAt` string, date-time, required — date-time of last update in channel
    - `rawReview` object, required — raw review object received from channel
    - `reviewReplies` object[]
      - `reviewReply` string — text of reply
      - `status` 'COMPLETED' | 'FAILED' | 'PENDING'
      - `replyAt` string, date-time

## Other responses

- `400` — Bad request
- `401` — Not authorized
- `403` — Forbidden
- `404` — Not found
- `429` — Too many requests

---

[API](https://skmtc.dev/guesty/apis/booking-engine-api.md) · [All operations](https://skmtc.dev/guesty/apis/booking-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/guesty/booking-engine-api/revisions/90f25f70255b/schema)