# Retrieve a conversation

Use this endpoint to retrieve a conversation available to the authenticated user.

Endpoint: POST /messages/conversations
Version: 3.2-Beta
Security: BearerAuth

## Header parameters:

  - `X-Affiliate-Id` (integer, required)
    Include here your Affiliate identifier number

## Request fields (application/json):

  - `accommodation` (string, required)
    The unique identifier of the property

  - `conversation` (string)
    Uniquely identifies the conversation.

  - `reservation` (string)
    Unique identifier of the reservation associated with this conversation.

## Response 200 fields (application/json):

  - `request_id` (string, required)
    Uniquely identifies the request. Please provide this identifier when contacting support.

  - `data` (object, required)

  - `data.conversation` (object, required)

  - `data.conversation.id` (string, required)
    Unique identifier of the conversation.

  - `data.conversation.reservation` (string)
    The unique identifier of the reservation

  - `data.conversation.messages` (array, required)
    Chronological list of messages in the conversation.

  - `data.conversation.messages.id` (string, required)
    Unique identifier of the message.

  - `data.conversation.messages.sender` (string, required)
    Unique identifier of the sender (either property or guest).

  - `data.conversation.messages.content` (string, required)
    Message content in plain text.

  - `data.conversation.messages.attachments` (array)
    List of attachment IDs included with the message (if any).

  - `data.conversation.messages.timestamp` (string, required)
    The timestamp in ISO-8601 format from which the message is sent. Format: YYYY-MM-DDTHH:mm:ss+00:00

  - `data.conversation.participants` (array, required)
    List of participants in the conversation, including guest and property.

  - `data.conversation.participants.id` (string, required)
    Unique identifier of the participant.

  - `data.conversation.participants.metadata` (object, required)

  - `data.conversation.participants.metadata.type` (string)
    Type of the metadata
    Enum: "guest", "property"

  - `data.conversation.participants.metadata.name` (string)
    Uniquely identifies the metadata.