---
title: "List reservation comments"
method: GET
path: "/reservations-v3/{reservationId}/comments"
tags: ["Reservations Open Api [Beta]"]
---

# List reservation comments

`GET /reservations-v3/{reservationId}/comments`

Retrieve internal reservation comments for a reservation, including top-level threads and nested replies.

## Path parameters

- `reservationId` string, required

## Query parameters

- `limit` number
- `skip` number

## Response `200`

Success

- object
  - `comments` object[], required
    - `_id` string, required
    - `reservationId` string, required
    - `accountId` string, required
    - `author` object, required
      - `_id` string, required
      - `fullName` string, required
      - `picture` object, nullable
        - `_id` string, required
        - `thumbnail` string, required
        - `regular` string, required
      - `authorType` 'user' | 'open-api', required — Author source: Guesty user (`user`) or OAuth application (`open-api`)
    - `body` string, nullable, required
    - `mentions` string[], required
    - `edited` boolean, required
    - `deleted` boolean, required
    - `deletedAt` string, date-time
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time
    - `parentCommentId` string — Present on reply comments only
    - `reactions` object, required — Read-only reaction aggregates keyed by emoji type (map of emoji to count and reactors)
    - `replies` object[] — Replies to this top-level comment
      - `_id` string, required
      - `reservationId` string, required
      - `accountId` string, required
      - `author` object, required
        - `_id` string, required
        - `fullName` string, required
        - `picture` object, nullable
          - `_id` string, required
          - `thumbnail` string, required
          - `regular` string, required
        - `authorType` 'user' | 'open-api', required — Author source: Guesty user (`user`) or OAuth application (`open-api`)
      - `body` string, nullable, required
      - `mentions` string[], required
      - `edited` boolean, required
      - `deleted` boolean, required
      - `deletedAt` string, date-time
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time
      - `parentCommentId` string — Present on reply comments only
      - `reactions` object, required — Read-only reaction aggregates keyed by emoji type (map of emoji to count and reactors)
  - `meta` object, required
    - `total` number, required
    - `limit` number, required
    - `skip` number, required

## Other responses

- `400` — Returned if required fields are missing or there is a validation error in the request
- `404` — Returned if the reservation was not found
- `422` — Returned if the reservation is invalid for this account
- `500` — Indicates server-side error while processing the request

---

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