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

Возвращает список всех администраторов группового чата и канала (пользователей и ботов) и их данные, например: идентификатор, имя, никнейм, время последней активности, URL аватара, флаги администратора, владельца и бота, а также права на управление каналом или групповым чатом для пользователей-администраторов

Бот, чей токен `access_token` используется для авторизации, должен быть администратором этого чата или канала. Подробнее о правах — в описании [`POST /chats/{chatId}/members/admins`](/docs-api/methods/POST/chats/-chatId-/members/admins#Доступные%20права%20администратора)

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

curl -X GET "https://platform-api2.max.ru/chats/{chatId}/members/admins" \
  -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 группового чата или канала

## Результат

Список участников группового чата или канала с общей информацией о них, а также временем последней активности и списком прав доступа для пользователей и ботов, которые являются администраторами

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

Описание пользователя или бота. В случае с пользователем может принимать значение `null`, если описание не заполнено
URL аватара пользователя или бота в уменьшенном размере
URL аватара пользователя или бота в полном размере
Время последней активности пользователя в чате. Может быть устаревшим для суперчатов (равно времени вступления)
Является ли пользователь владельцем группового чата или канала
Является ли пользователь администратором группового чата или канала
Дата присоединения к чату в формате Unix timestamp в миллисекундах
Перечень прав доступа пользователя или бота, если тот является администратором группового чата или канала. Для обычных участников чата или канала поле не возвращается

 Если право назначается действующему администратору, то его текущие права будут обновлены в соответствии с переданным списком. Ниже приведено краткое описание всех прав — подробнее читайте [в разделе «Доступные права администратора»](/docs-api/methods/POST/chats/-chatId-/members/admins) 

 **Краткое описание доступных прав администратора**: 
- `read_all_messages` — читать все сообщения в канале или групповом чате 
- `edit` — редактировать посты и комментарии в каналах (для групповых чатов недоступно). Ранее вместо `edit` в API использовалось `edit_message` — в ответе могут возвращаться оба значения, однако при назначении новых прав администраторам используйте `edit` 
- `delete` — удалять посты и комментарии в каналах (для групповых чатов недоступно). Ранее вместо `delete` в API использовалось `delete_message` — в ответе могут возвращаться оба значения, однако при назначении новых прав администраторам используйте `delete` 
- `write` — редактировать и удалять сообщения в групповых чатах, а также писать посты и комментарии в каналах. Ранее вместо `write` в API использовалось `post_edit_delete_message` — в ответе могут возвращаться оба значения, однако при назначении новых прав администраторам используйте `write` 
- `pin_message` — закреплять сообщение 
- `change_chat_info` — изменять информацию о канале или групповом чате
- `add_remove_members` — добавлять и удалять участников группового чата (доступно пользователям и ботам) или подписчиков канала (доступно только пользователям) 
- `add_admins` — добавлять и удалять администраторов группового чата или канала
- `edit_link` — изменять ссылку на групповой чат (для каналов недоступно)
- `can_call` — звонить в групповом чате (для каналов недоступно) 
- `view_stats` — право на просмотр статистики каналов (для групповых чатов недоступно). Назначается по умолчанию владельцам каналов. Для других пользователей-администраторов канала и ботов недоступно
Описание роли, которое будет отображаться на клиентском устройстве в настройках чата или канала рядом с именем пользователя 

Если пользователь администратор или владелец и ему не установлено это название, то поле не передаётся, клиентское устройство на своей стороне подменит значение на соответствующее: "владелец" или "админ"

Указатель на следующую страницу данных

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

| Код | Описание |
| --- | --- |
| `200` | Список администраторов в групповом чате или канале |
| `401` | Ошибка авторизации. Токен `access_token` указан некорректно или недействителен |
| `403` | Ошибка доступа. У вас нет прав на доступ к этому ресурсу |
| `404` | Запрашиваемый ресурс не найден |
| `500` | Внутренняя ошибка сервера |