---
title: "listConversations - List all order conversations"
method: GET
path: "/conversations"
tags: ["Conversations"]
---

# listConversations - List all order conversations

`GET /conversations`

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

Use this API to synchronize Mirakl Connect conversations with your system.

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

<p>This resource supports seek pagination (<a href="#section/Seek-pagination-and-sort">see documentation</a>)</p>

<div class="extension-title">Sort fields</div>

<code>sort</code> field can have the following values:<ul><li><b>updated_at</b> (Default) - Sort by date time of last conversation modification in Mirakl Connect (desc by default)</li></ul>

</div>

## Query parameters

- `page_token` string
- `limit` integer
- `updated_from` string, date-time
- `entity_type` 'ORDER'
- `entity_ids` string[]
- `conversation_ids` string[]

## Response `200`

List of conversations matching the filter parameters

- ConversationsPageResponse
  - `next_page_token` string — Token to access the next page. Absent if the current page is the last one.
  - `previous_page_token` string — Token to access the previous page. Absent if the current page is the first one.
  - `data` ConversationResponse[], required — Page of conversations corresponding to the filter parameters
    - `anonymized_at` string, date-time — Date and time when the conversation was anonymized. Absent if the conversation has not been anonymized.
    - `channel_conversation_id` string, required — Unique identifier of the conversation on the channel
    - `created_at` string, date-time, required — Date and time when the conversation was created
    - `entity` object, required — Entity linked to the conversation
      - `channel_entity_id` string, required — Unique identifier of the entity on the channel
      - `id` string — Connect identifier of the entity. Null if the entity is not yet known to Connect.
      - `type` string, required — Type of the entity Enum: `"ORDER"`
    - `id` string, required — Unique identifier of the conversation
    - `origin` ConversationOrigin, required
      - `channel_id` string, required — Unique identifier of the sales channel
      - `channel_name` string, required — Name of the sales channel
      - `channel_store_id` string, required — Store identifier on the sales channel. This identifier is not guaranteed to be unique as multiple channels can use the same identifier.
      - `channel_store_name` string, required — Store public name on the sales channel
    - `participants` ConversationParticipant[], required — List of participants in the conversation
      - `id` string — Unique identifier of the participant. Null for type `CUSTOMER`.
      - `name` string, required — Display name of the participant
      - `type` string, required — Type of the participant Enum: `"CHANNEL"`, `"CUSTOMER"`
    - `topic` object, required — Topic of the conversation
      - `type` string, required — Type of the topic Enum: `"FREE_TEXT"`
      - `value` string, required — Value of the topic
    - `updated_at` string, date-time, required — Date and time when the conversation was last updated. This is updated when a new message is received in the conversation.

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/mirakl/apis/mirakl-connect-apis.md) · [All operations](https://skmtc.net/mirakl/apis/mirakl-connect-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mirakl/mirakl-connect-apis/revisions/cc009fec5cdd/schema)