---
title: "List Teams"
method: GET
path: "/team-messaging/v1/teams"
tags: ["Teams"]
---

# List Teams

`GET /team-messaging/v1/teams`

Returns the list of teams where the user is a member (both archived and active) combined with a list of public teams that can be joined by the current user. All records in response are sorted by creation time of a chat in ascending order. A team is a chat between 2 and more (unlimited number) participants assigned with specific name.

## Query parameters

- `recordCount` integer
- `pageToken` string

## Response `200`

OK

- TMTeamList
  - `records` TMTeamInfo[], required — List of teams
    - `id` string — Internal identifier of a team
    - `type` 'Team' — Type of chat
    - `public` boolean — Team access level
    - `name` string — Team name
    - `description` string — Team description
    - `status` 'Active' | 'Archived' — Team status
    - `creationTime` string, date-time — Team creation datetime in ISO 8601 format
    - `lastModifiedTime` string, date-time — Team last change datetime in ISO 8601 format
  - `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)