---
title: "List Chats"
method: GET
path: "/team-messaging/v1/chats"
tags: ["Chats"]
---

# List Chats

`GET /team-messaging/v1/chats`

Returns the list of chats where the user is a member and also public teams that can be joined.

All records in response are sorted by creation time of a chat in ascending order.

**Chat types**

There are multiple types of chats, including:

* **Personal** - each user is given a dedicated "personal chat" in which they are the only member.
* **Direct** - a chat between two individuals.
* **Group** - a chat between three or more named individuals. A "group" chat has no name.
* **Team** - a chat related to a specific topic. Members can come and go freely from this chat type.
* **Everyone** - a special chat containing every individual in a company.

## Query parameters

- `type` string[]
- `recordCount` integer
- `pageToken` string

## Response `200`

OK

- TMChatList
  - `records` TMChatInfo[], required — List of chats
    - `id` string — Internal identifier of a chat
    - `type` 'Everyone' | 'Team' | 'Group' | 'Direct' | 'Personal' — Type of chat
    - `public` boolean — For 'Team' chat type only. Team access level.
    - `name` string — For 'Team','Everyone' chats types only. Chat name.
    - `description` string — For 'Team','Everyone' chats types only. Chat description.
    - `status` 'Active' | 'Archived' — For 'Team' chat type only. Team status.
    - `creationTime` string, date-time — Chat creation datetime in ISO 8601 format
    - `lastModifiedTime` string, date-time — Chat 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)