---
title: "Get Conversation Details"
method: GET
path: "/conversations/{conversation_id}"
tags: ["Messages"]
---

# Get Conversation Details

`GET /conversations/{conversation_id}`

This endpoint is used to retrieve the messages and details of a conversation. <br><br>We are constantly improving our API which could mean that message schema may change. In order to maintain a healthy integration, your Application must parse and ignore unexpected parameters instead of throwing errors.

## Path parameters

- `conversation_id` string, 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
    - `id` string, required — The id of the conversation.
    - `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.
    - `guest` object, required — The guest's information.
      - `name` string — The name of the guest.
      - `phone` string — The phone of the guest.
      - `email` string — The email of the guest.
    - `activities` object[], required — A list of activities associated with the conversation.
      - `activity_type` 'inquiry' | 'reservation' — The type of activity.
      - `reservation_code` string, nullable — The reservation code related to the activity, if applicable.
      - `check_in_date` string, date, nullable — The check-in date related to the activity.
      - `check_out_date` string, date, nullable — The check-out date related to the activity.
      - `listing_id` string, nullable — The listing id related to the activity.
      - `property` object, nullable — Details of the property related to the activity.
        - `id` integer — The id of the property.
        - `title` string — The title of the property.
        - `cover_url` string, nullable — The URL of the property's cover image.
        - `room_type` object, nullable — Details of the room type related to the activity.
          - `id` integer — The id of the room type.
          - `title` string — The title of the room type.
    - `note` string — Any notes related to the conversation.
    - `messages` object[], required — List of messages within the conversation.
      - `id` string — The id of the message.
      - `sender_role` string — The role of the message sender, either 'host' or 'guest'.
      - `sender_name` string, nullable — Display name of the sender when known. For host-side messages this is the real operator account name; for HostGPT-generated messages this is `HostGPT`; for shadow HostGPT preview messages this is a localized HostGPT label. `null` for guest messages and other cases where the sender cannot be resolved.
      - `sources` object[] — Knowledge sources cited by HostGPT to generate this message, grouped by `type` (e.g. `checkin_guide`, `automation_reply`, `host_knowledge`, `thread`, `host_assistant`). Empty array for human-sent messages and HostGPT messages without resolved citations.
        - `type` string — Source group type.
        - `docs` object[] — Individual documents grouped under this source type.
          - `title` string — Title of the source document.
          - `fragment` string[] — Quoted text fragments from this source.
          - `source_type` string — Same as the parent `type`.
          - `link_id` integer — Internal id linking back to the underlying record (property id for `checkin_guide`, rule id for `automation_reply`, knowledge id for `host_knowledge`, or -1 when unknown).
      - `display_type` 'Text' | 'Box' | 'FileAttachment' | 'RequestToBook' | 'BsRequestBook' | 'SpecialOffer' | 'ReservationAlteration' | 'HouseLinkCard' — The display type of the message.
      - `content` string — The text content of the message.
      - `attachment` object, nullable — Any attachment included with the message.
      - `created_at` string, date-time — The timestamp of when the message was created.

---

[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)