---
title: "Fetch all messages on a single thread."
method: GET
path: "/v2/messages"
tags: ["Messages"]
---

# Fetch all messages on a single thread.

`GET /v2/messages`

## Query parameters

- `threadId` integer, required
- `since_utc` string, date-time, nullable
- `include_drafts` boolean
- `include_attachments` boolean

## Response `200`

A pageable enumeration of messages.

- ThreadPagedMessageModel — A pageable list of thread messages with associated thread and guest details.
  - `items` ThreadMessageViewModel[] — The subset of records for the current page in the collection.
    - `id` integer — The ID of this record.
    - `attachment_urls` string[] — A list of URLs for downloading attachments to this message. URLs are temporary and will expire after a set time.
    - `body` string — The message text.
    - `date_utc` string, date-time — The date this message was sent or received.
    - `from_contact_id` integer — The ID of the guest or contact who wrote this message.
    - `from_role` 'owner' | 'guest' | 'co_host' | 'support' | 'other' | 'cotraveler' | 'third_party_booker' — The role of the contact who wrote a message.
    - `is_draft` boolean — Indicates an unsent draft.
    - `removed_utc` string, date-time, nullable — The date this message was removed.
    - `thread` ThreadPartialModel — Partial details about the thread.
      - `id` integer — The ID of this record.
      - `booking_id` integer, nullable — The ID of the most recent booking associated with this thread, if any.
      - `channel` 'unknown' | 'booking_com' | 'trip_advisor' | 'canada_stays' | 'vrbo' | 'airbnb' | 'florida_rentals' | 'houfy' | 'home_to_go' | 'smoky_mountains' | 'ha_xml_sandbox' | 'find_rentals' | 'guest_smiles' | 'getaway_go_go' | 'whimstay' | 'golightly' | 'ecbyo' | 'google_vacation_rentals' | 'rentalz' | 'savvy' | 'mrbo_and_american_snowbird' | 'ha_xml_sandbox_mo_r' | 'nofie' | 'hopper_homes' | 'book_direct_forgotten_coast' | 'florida_rental_by_owners' | 'got2_go' | 'glamping_hub' | 'local_ota' | 'avanti' | 'stay' | 'crewdogs' | 'lake' | 'wander' | 'vidle_housing' | 'foxhole' | 'travelstaytion' | 'marriott' | 'broken_bow' | 'branson_premier' | 'inhaven' | 'trip_skip' | 'home_away' | 'owner_rez_hosted_site'
      - `inquiry_id` integer, nullable — The ID of the most recent inquiry associated with this thread, if any.
      - `property_id` integer, nullable — The ID of the property associated with this thread, if any.
      - `quote_id` integer, nullable — The ID of the most recent quote associated with this thread, if any.
      - `type` 'channel' | 'sms' | 'email' | 'direct' | 'whats_app'
    - `thread_id` integer — The ID of the thread on which this message was posted.
  - `limit` integer — The maximum number of records per page.
  - `next_page_url` string — URL to fetch the next page of records. A null value indicates that there are no more pages in the collection.
  - `offset` integer — The current offset from the start of the collection.
  - `guest` GuestPartialModel — Partial details about the guest. For full details, use the guests endpoint.
    - `id` integer — The ID of this record.
    - `first_name` string
    - `last_name` string
  - `thread` ThreadPartialModel — Partial details about the thread.
    - `id` integer — The ID of this record.
    - `booking_id` integer, nullable — The ID of the most recent booking associated with this thread, if any.
    - `channel` 'unknown' | 'booking_com' | 'trip_advisor' | 'canada_stays' | 'vrbo' | 'airbnb' | 'florida_rentals' | 'houfy' | 'home_to_go' | 'smoky_mountains' | 'ha_xml_sandbox' | 'find_rentals' | 'guest_smiles' | 'getaway_go_go' | 'whimstay' | 'golightly' | 'ecbyo' | 'google_vacation_rentals' | 'rentalz' | 'savvy' | 'mrbo_and_american_snowbird' | 'ha_xml_sandbox_mo_r' | 'nofie' | 'hopper_homes' | 'book_direct_forgotten_coast' | 'florida_rental_by_owners' | 'got2_go' | 'glamping_hub' | 'local_ota' | 'avanti' | 'stay' | 'crewdogs' | 'lake' | 'wander' | 'vidle_housing' | 'foxhole' | 'travelstaytion' | 'marriott' | 'broken_bow' | 'branson_premier' | 'inhaven' | 'trip_skip' | 'home_away' | 'owner_rez_hosted_site'
    - `inquiry_id` integer, nullable — The ID of the most recent inquiry associated with this thread, if any.
    - `property_id` integer, nullable — The ID of the property associated with this thread, if any.
    - `quote_id` integer, nullable — The ID of the most recent quote associated with this thread, if any.
    - `type` 'channel' | 'sms' | 'email' | 'direct' | 'whats_app'

---

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