---
title: "GET /messages/conversations"
method: GET
path: "/messages/conversations"
tags: ["ConversationThread"]
---

# GET /messages/conversations

`GET /messages/conversations`

Retrieves list of conversations.

## Query parameters

- `api-version` string, required
- `maxPageSize` integer
- `participantId` string
- `channelId` string, uuid

## Headers

- `x-ms-client-request-id` string, uuid

## Response `200`

The request has succeeded.

- PagedConversation — Paged collection of Conversation items
  - `value` CommunicationConversation[], required — The Conversation items on this page
    - `id` string, required — The conversation ID.
    - `topic` string — The conversation topic.
    - `deliveryChannelIds` string[] — List of delivery channel IDs.
    - `outboundDeliveryStrategy` 'internalOnly' | 'allParticipants' — The options of the outbound delivery strategy for messages sent by participants in a conversation.
    - `participants` ConversationParticipant[] — List of participants involved in the conversation.
      - `id` string, required — Participant Identifier.
      - `displayName` string — Participant display name.
      - `kind` 'internal' | 'external', required — The type of a participant in a threaded conversation.
  - `nextLink` string, uri — The link to the next page of items

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/communication-messages.md) · [All operations](https://skmtc.net/azure/apis/communication-messages/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/communication-messages/versions/ec11c913a0e6/schema)