---
title: "Retrieve a conversation"
method: POST
path: "/messages/conversations"
tags: ["Conversations"]
---

# Retrieve a conversation

`POST /messages/conversations`

Retrieves a conversation accessible to the authenticated user, including message history and participants.

## Headers

- `X-Affiliate-Id` integer, required

## Request body

- union
  - object
    - `accommodation` string, required — Unique identifier of the property.
    - `reservation` string, required — Unique identifier of the reservation.
  - object
    - `accommodation` string, required — Unique identifier of the property.
    - `conversation` string, required — Unique identifier of the conversation.

## Response `200`

Conversation retrieved successfully.

- object
  - `request_id` string — Unique identifier for this request. Provide this ID when contacting support.
  - `data` object
    - `conversation` object
      - `id` string — Unique identifier of the conversation.
      - `reservation` string — Unique identifier of the reservation.
      - `messages` object[] — List of messages in the conversation.
        - `id` string — Unique identifier of the message.
        - `sender` string — Unique identifier of the sender.
        - `reply_to` string — Message ID this message replies to (if applicable).
        - `content` string — Message text content.
        - `attachments` string[]
        - `timestamp` string, date-time — Timestamp in ISO 8601 format (UTC) when the message was sent.
      - `participants` object[] — List of participants in the conversation.
        - `id` string — Unique identifier of the participant.
        - `metadata` object — Additional participant metadata.

---

[API](https://skmtc.net/booking/apis/booking-com-demand-api.md) · [All operations](https://skmtc.net/booking/apis/booking-com-demand-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/booking/booking-com-demand-api/revisions/e5f3dccae7ca/schema)