---
title: "Get Chat"
method: GET
path: "/team-messaging/v1/chats/{chatId}"
tags: ["Chats"]
---

# Get Chat

`GET /team-messaging/v1/chats/{chatId}`

Returns information about a chat by ID.

**Note** 'Chat' is a general name for all types of threads including *Personal* (user's own me-chat), *Direct* (one on one chat), *Group* (chat of 3-15 participants without specific name), *Team* (chat of 2 and more participants, with a specific name), *Everyone* (company chat including all employees, with a specific name)."

## Path parameters

- `chatId` string, required

## Response `200`

OK

- TMChatInfo
  - `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

## Other responses

- `404` — Chat Not Found.

---

[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/versions/8d602198ec97/schema)