---
title: "List Conversations"
method: GET
path: "/team-messaging/v1/conversations"
tags: ["Conversations"]
---

# List Conversations

`GET /team-messaging/v1/conversations`

Returns the list of conversations where the user is a member. All records in response are sorted by creation time of a conversation in ascending order. Conversation is a chat of the *Group* type.

## Query parameters

- `recordCount` integer
- `pageToken` string

## Response `200`

OK

- TMConversationList
  - `records` TMConversationInfo[], required — List of conversations
    - `id` string — Internal identifier of a conversation
    - `type` 'Direct' | 'Personal' | 'Group' — Type of conversation
    - `creationTime` string, date-time — Conversation creation datetime in ISO 8601 format
    - `lastModifiedTime` string, date-time — Conversation last change datetime in ISO 8601 format
    - `members` TMChatMemberInfo[]
      - `id` string — Internal identifier of a user
  - `navigation` TMNavigationInfo
    - `prevPageToken` string — Previous page token. To get previous page, user should pass one of returned token in next request and, in turn, required page will be returned with new tokens
    - `nextPageToken` string — Next page token. To get next page, user should pass one of returned token in next request and, in turn, required page will be returned with new tokens

---

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