---
title: "GetConversations"
method: GET
path: "/v3/conversations"
tags: ["Conversations"]
---

# GetConversations

`GET /v3/conversations`

List the Conversations in which this bot has participated.

GET from this method with a skip token

The return value is a ConversationsResult, which contains an array of ConversationMembers and a skip token.  If the skip token is not empty, then 
there are further values to be returned. Call this method again with the returned token to get more values.

Each ConversationMembers object contains the ID of the conversation and an array of ChannelAccounts that describe the members of the conversation.

## Query parameters

- `continuationToken` string

## Response `200`

An object will be returned containing 
* an array (Conversations) of ConversationMembers objects
* a continuation token

Each ConversationMembers object contains:
* the Id of the conversation
* an array (Members) of ChannelAccount objects

- ConversationsResult — Conversations result
  - `continuationToken` string — Paging token
  - `conversations` ConversationMembers[] — List of conversations
    - `id` string — Conversation ID
    - `members` ChannelAccount[] — List of members in this conversation
      - `id` string — Channel id for the user or bot on this channel (Example: joe@smith.com, or @joesmith or 123456)
      - `name` string — Display friendly name
      - `role` 'user' | 'bot'

## Other responses

- `default` — The operation failed and the response is an error object describing the status code and failure.

---

[API](https://skmtc.net/poshbotio/apis/microsoft-bot-connector-api-v3-0.md) · [All operations](https://skmtc.net/poshbotio/apis/microsoft-bot-connector-api-v3-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/poshbotio/microsoft-bot-connector-api-v3-0/versions/ea45ea47a3fb/schema)