---
title: "getConversationMessages - Get messages for a conversation"
method: GET
path: "/conversations/{conversationId}"
tags: ["Conversations"]
---

# getConversationMessages - Get messages for a conversation

`GET /conversations/{conversationId}`

## Request

- Base URL: `https://miraklconnect.com/api`
- URL: `https://miraklconnect.com/api/conversations/{conversationId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/mirakl/apis/mirakl-connect-apis/docs/conversations/:conversationId/get.ts> (a function with typed inputs; its response is checked against the schema)

<div class="extension-title">Description</div>

Returns messages of a conversation, ordered by channel creation date descending.

<div class="api-description-extension">
</div>

## Path parameters

- `conversationId` string, required

## Query parameters

- `message_after` string, date-time

## Response `200`

Messages for the conversation

- ConversationMessagesResponse
  - `messages` MessageResponse[], required: List of messages in the conversation
    - `attachments` MessageAttachment[]: List of file attachments on this message
      - `filename` string, required: Original filename of the attachment
      - `id` string, required: Unique identifier of the attachment in Connect
      - `size_in_bytes` integer, required: Size of the attachment in bytes
    - `body` string, required: Content of the message
    - `channel_created_at` string, date-time, required: Date and time when the message was created on the channel
    - `channel_message_id` string, required: Unique identifier of the message on the channel
    - `created_at` string, date-time, required: Date and time when the message was stored in Connect
    - `id` string, required: Unique identifier of the message in Connect
    - `sender` MessageSender, required
      - `id` string: Unique identifier of the sender. Null for type `CUSTOMER`
      - `name` string, required: Display name of the sender
      - `type` 'CUSTOMER' | 'STORE' | 'CHANNEL', required: Type of the sender
    - `visible_to_customer` boolean: Whether the message is visible to the customer or not. When false the message is only visible to you and the channel. Note that when using createMessage API, the message is always sent to the customer.

## Other responses

- `404`: Conversation not found or anonymized

## Changes

- **2026-10-14** `d12b10bceb6a`: 3 warning
  - added the new `CHANNEL` enum value to the `messages/items/sender/type` response property for the response status `200`
  - added the new `CUSTOMER` enum value to the `messages/items/sender/type` response property for the response status `200`
  - added the new `STORE` enum value to the `messages/items/sender/type` response property for the response status `200`

[Operation history](https://skmtc.dev/mirakl/apis/mirakl-connect-apis/changes/conversations/:conversationId/get.md)

---

[API](https://skmtc.dev/mirakl/apis/mirakl-connect-apis.md) - [All operations](https://skmtc.dev/mirakl/apis/mirakl-connect-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/mirakl/apis/mirakl-connect-apis/revisions/c0527a972b89?raw)