Для корректной работы ваших чат-ботов и мини-приложений направляйте запросы на домен `platform-api2.max.ru` вместо `platform-api.max.ru`. Также убедитесь, что добавили сертификат Минцифры в список доверенных

Возвращает информацию о групповом чате или канале по его ID

Пример запроса:

curl -X GET "https://platform-api2.max.ru/chats/{chatId}" \
  -H "Authorization: {access_token}"

## Авторизация

> Передача токена через query-параметры больше не поддерживается — используйте заголовок `Authorization: `

Токен для вызова HTTP-запросов присваивается при создании бота — его можно найти на [платформе](https://business.max.ru/self) в разделе **Чат-боты**. Выберите необходимого бота и нажмите **⋮** → **Настройки** → значок копирования справа от поля с токеном

Если вы верифицировали профиль и создали бота в [мини-приложении «MAX для бизнеса»](https://max.ru/business_bot?startapp), получить токен можно там же или в [боте «MAX для бизнеса»](https://max.ru/business_bot) с помощью команды **Получить токен**

Рекомендуем не разглашать токен посторонним, чтобы они не получили доступ к управлению ботом.
Токен может быть отозван за нарушение Правил платформы

## Параметры

ID запрашиваемого группового чата или канала. Как получить ID — в [разделе «Получение chat_id»](/docs-api#Получение%20chat_id)

## Результат

ID чата или канала — в зависимости от ограничений метода и от того, с чем вы работаете. Как получить ID — в [разделе «Получение chat_id»](/docs-api#Получение%20chat_id)
Возможные значения в enum: `"chat"` `"channel"` `"dialog"`

Тип чата:
 - `"chat"` — Групповой чат
 - `"channel"` — Канал
 - `"dialog"` — Диалог
Возможные значения в enum: `"active"` `"removed"` `"left"` `"closed"`

Статус чата:
- `"active"` — Бот является активным участником чата
- `"removed"` — Бот был удалён из чата
- `"left"` — Бот покинул чат
- `"closed"` — Чат был закрыт
Отображаемое название чата или канала. Может быть `null` для диалогов
Аватар группового чата или канала

URL изображения

Время последнего события в чате или канале в формате Unix timestamp в миллисекундах
Количество участников чата или канала. Для диалогов всегда `2`
ID владельца чата или канала
Список участников в формате ключ-значение, где ключ — идентификатор участника `user_id`, а значение — время его последней активности в чате или канале `last_event_time`. Может быть `null`, если запрашивается список чатов
Параметр показывает, доступен ли групповой чат или канал публично. Для диалогов и приватных каналов — всегда `false`
Ссылка на чат
Описание чата или канала
Данные о пользователе в диалоге (только для чатов типа `"dialog"`)

Идентификатор пользователя или бота
Отображаемое имя пользователя или бота
Отображаемая фамилия пользователя. Для ботов это поле не возвращается
Никнейм бота или уникальное публичное имя пользователя. В случае с пользователем может быть `null`, если тот недоступен или имя не задано
`true`, если это бот
Время последней активности пользователя или бота в MAX (Unix timestamp в миллисекундах). Если пользователь отключил в настройках профиля мессенджера MAX возможность видеть, что он в сети онлайн, поле может не возвращаться
_Устаревшее поле, скоро будет удалено_
до `16000` символов

Описание пользователя или бота. В случае с пользователем может принимать значение `null`, если описание не заполнено
URL аватара пользователя или бота в уменьшенном размере
URL аватара пользователя или бота в полном размере

Количество сообщений в групповом чате или постов канале
Закреплённое сообщение в чате (возвращается только при запросе конкретного чата или канала)

Отправитель сообщения: пользователь или бот

**Обратите внимание**:
- Все параметры в объекте относятся к отправителю сообщения
- Объект отсутствует, если сообщение отправлено в канал

Идентификатор пользователя или бота
Отображаемое имя пользователя или бота
Отображаемая фамилия пользователя. Для ботов это поле не возвращается
Никнейм бота или уникальное публичное имя пользователя. В случае с пользователем может быть `null`, если тот недоступен или имя не задано
`true`, если это бот
Время последней активности пользователя или бота в MAX (Unix timestamp в миллисекундах). Если пользователь отключил в настройках профиля мессенджера MAX возможность видеть, что он в сети онлайн, поле может не возвращаться
_Устаревшее поле, скоро будет удалено_

Получатель сообщения: пользователь или бот (для диалога), канал или чат

 **Обратите внимание**: все параметры в объекте относятся к получателю сообщения

ID чата или канала. Как получить ID — в [разделе «Получение chat_id»](/docs-api#Получение%20chat_id)
Возможные значения в enum: `"chat"` `"channel"` `"dialog"`

Тип чата:
 - `chat` — групповой чат
 - `channel` — канал или комментарий к посту (для вызовов методов группы `/comments`)
 - `dialog` — диалог
ID получателя сообщения в диалоге (пользователя или бота). Если сообщение отправлено в групповой чат или канал, то параметр отсутствует
Идентификатор поста в канале, к которому оставлен комментарий

Время создания сообщения в формате Unix timestamp в миллисекундах
Пересланное или ответное сообщение

Возможные значения в enum: `"forward"` `"reply"`

Тип связанного сообщения:
  - `"reply"` — ответ на сообщение в чате 
- `"forward"` — пересланное сообщение в чате
Пользователь или бот, отправивший сообщение

Идентификатор пользователя или бота
Отображаемое имя пользователя или бота
Отображаемая фамилия пользователя. Для ботов это поле не возвращается
Никнейм бота или уникальное публичное имя пользователя. В случае с пользователем может быть `null`, если тот недоступен или имя не задано
`true`, если это бот
Время последней активности пользователя или бота в MAX (Unix timestamp в миллисекундах). Если пользователь отключил в настройках профиля мессенджера MAX возможность видеть, что он в сети онлайн, поле может не возвращаться
_Устаревшее поле, скоро будет удалено_

Чат или канал, в котором сообщение было изначально опубликовано. Только для пересланных сообщений с `type = forward`. Как получить ID — в [разделе «Получение chat_id»](/docs-api#Получение%20chat_id)
Информация о сообщении

Уникальный ID сообщения
ID расположения сообщения в чате по порядку
Текст сообщения
Вложения сообщения. Могут быть одним из типов `attachment`, описанных в схеме ниже
Если поле пустое или равно `null`, изменений не произойдет. Если массив пуст, все вложения будут удалены

Данные, использованные для отправки изображения

Уникальный ID этого изображения
Токен вложения — уникальный ID загруженного медиа: изображения, аудио, видео или файла. Возвращается в ответ на вызов [POST /uploads](/docs-api/methods/POST/uploads)
URL изображения. Время жизни ссылки ограниченно. Срок истечения указан в параметре `expires` — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android

Разметка текста сообщения. Подробнее — в разделе [Форматирование](/docs-api#Форматирование%20текста%20в%20сообщениях)

Тип элемента разметки. Может быть **жирный**,  *курсив*, ~зачеркнутый~, подчеркнутый, `моноширинный`, выделенный, цитата, заголовок, ссылка или упоминание пользователя

**Обратите внимание**: в тексте комментариев не поддерживаются гиперссылки и упоминание пользователей
Индекс начала элемента разметки в тексте. Нумерация с нуля
Длина элемента разметки в символах

Содержимое сообщения. Текст + вложения. Может быть `null`, если сообщение содержит только пересланное сообщение

Уникальный ID сообщения
ID расположения сообщения в чате по порядку
Текст сообщения
Вложения сообщения. Могут быть одним из типов `attachment`, описанных в схеме ниже
Если поле пустое или равно `null`, изменений не произойдет. Если массив пуст, все вложения будут удалены

Данные, использованные для отправки изображения

Уникальный ID этого изображения
Токен вложения — уникальный ID загруженного медиа: изображения, аудио, видео или файла. Возвращается в ответ на вызов [POST /uploads](/docs-api/methods/POST/uploads)
URL изображения. Время жизни ссылки ограниченно. Срок истечения указан в параметре `expires` — если он истёк, ссылку необходимо запросить повторно. Доступно в веб-клиентe и на Android

Разметка текста сообщения. Подробнее — в разделе [Форматирование](/docs-api#Форматирование%20текста%20в%20сообщениях)

Тип элемента разметки. Может быть **жирный**,  *курсив*, ~зачеркнутый~, подчеркнутый, `моноширинный`, выделенный, цитата, заголовок, ссылка или упоминание пользователя

**Обратите внимание**: в тексте комментариев не поддерживаются гиперссылки и упоминание пользователей
Индекс начала элемента разметки в тексте. Нумерация с нуля
Длина элемента разметки в символах

Статистика просмотров постов и репостов — возвращается только для каналов

Количество пользователей, которые увидели пост или репост в канале. Просмотр засчитывается, когда пост или репост попадает в область видимости экрана
Если это репост, то будет показано количество именно его просмотров

Публичная ссылка на пост в канале. Отсутствует для диалогов и групповых чатов

## Коды ответов

| Код | Описание |
| --- | --- |
| `200` | Информация о групповом чате или канале |
| `401` | Ошибка авторизации. Токен `access_token` указан некорректно или недействителен |
| `500` | Внутренняя ошибка сервера |