---
title: "Read messages with the host"
method: GET
path: "/v1/bookings/{booking_id}/messages"
tags: ["Bookings"]
---

# Read messages with the host

`GET /v1/bookings/{booking_id}/messages`

## Request

- Base URL: `https://threshold.rentals/api`
- URL: `https://threshold.rentals/api/v1/bookings/{booking_id}/messages`
- Auth: HTTP bearer

The guest–host conversation on a booking, oldest first, including the guest's note with the request and the host's note with their decision.

## Path parameters

- `booking_id` string, required

## Response `200`

The conversation

- MessageThread
  - `booking_id` string
  - `can_send` boolean
  - `messages` Message[]
    - `id` string
    - `from` 'guest' | 'host'
    - `body` string
    - `sent_at` string, date-time
    - `note` string

## Other responses

- `401`: Agent token missing (unauthorized)
- `404`: Not found (property_not_found, quote_not_found, booking_not_found)
- `429`: Rate limited or too many open requests: see Retry-After

---

[API](https://skmtc.dev/threshold/apis/threshold-stays-api.md) · [All operations](https://skmtc.dev/threshold/apis/threshold-stays-api/llms.txt) · [OpenAPI document](https://skmtc.dev/threshold/apis/threshold-stays-api/revisions/7acf3ae91b56?raw)
