---
title: "POST /getChatAdministrators"
method: POST
path: "/getChatAdministrators"
---

# POST /getChatAdministrators

`POST /getChatAdministrators`

Use this method to get a list of administrators in a chat. On success, returns an Array of [ChatMember](https://core.telegram.org/bots/api/#chatmember) objects that contains information about all chat administrators except other bots. If the chat is a group or a supergroup and no administrators were appointed, only the creator will be returned.

## Request body

- object
  - `chat_id` union, required — Unique identifier for the target chat or username of the target supergroup or channel (in the format `@channelusername`)
    - integer
    - string

## Response `200`

- object
  - `ok` boolean, required
  - `result` ChatMember[], required
    - `user` User, required — This object represents a Telegram user or bot.
      - `id` integer, required — Unique identifier for this user or bot
      - `is_bot` boolean, required — True, if this user is a bot
      - `first_name` string, required — User's or bot's first name
      - `last_name` string — *Optional*. User's or bot's last name
      - `username` string — *Optional*. User's or bot's username
      - `language_code` string — *Optional*. [IETF language tag](https://en.wikipedia.org/wiki/IETF_language_tag) of the user's language
      - `can_join_groups` boolean — *Optional*. True, if the bot can be invited to groups. Returned only in [getMe](https://core.telegram.org/bots/api/#getme).
      - `can_read_all_group_messages` boolean — *Optional*. True, if [privacy mode](https://core.telegram.org/bots#privacy-mode) is disabled for the bot. Returned only in [getMe](https://core.telegram.org/bots/api/#getme).
      - `supports_inline_queries` boolean — *Optional*. True, if the bot supports inline queries. Returned only in [getMe](https://core.telegram.org/bots/api/#getme).
    - `status` 'creator' | 'administrator' | 'member' | 'restricted' | 'left' | 'kicked', required — The member's status in the chat. Can be “creator”, “administrator”, “member”, “restricted”, “left” or “kicked”
    - `custom_title` string — *Optional*. Owner and administrators only. Custom title for this user
    - `is_anonymous` boolean — *Optional*. Owner and administrators only. True, if the user's presence in the chat is hidden
    - `can_be_edited` boolean — *Optional*. Administrators only. True, if the bot is allowed to edit administrator privileges of that user
    - `can_post_messages` boolean — *Optional*. Administrators only. True, if the administrator can post in the channel; channels only
    - `can_edit_messages` boolean — *Optional*. Administrators only. True, if the administrator can edit messages of other users and can pin messages; channels only
    - `can_delete_messages` boolean — *Optional*. Administrators only. True, if the administrator can delete messages of other users
    - `can_restrict_members` boolean — *Optional*. Administrators only. True, if the administrator can restrict, ban or unban chat members
    - `can_promote_members` boolean — *Optional*. Administrators only. True, if the administrator can add new administrators with a subset of their own privileges or demote administrators that he has promoted, directly or indirectly (promoted by administrators that were appointed by the user)
    - `can_change_info` boolean — *Optional*. Administrators and restricted only. True, if the user is allowed to change the chat title, photo and other settings
    - `can_invite_users` boolean — *Optional*. Administrators and restricted only. True, if the user is allowed to invite new users to the chat
    - `can_pin_messages` boolean — *Optional*. Administrators and restricted only. True, if the user is allowed to pin messages; groups and supergroups only
    - `is_member` boolean — *Optional*. Restricted only. True, if the user is a member of the chat at the moment of the request
    - `can_send_messages` boolean — *Optional*. Restricted only. True, if the user is allowed to send text messages, contacts, locations and venues
    - `can_send_media_messages` boolean — *Optional*. Restricted only. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes
    - `can_send_polls` boolean — *Optional*. Restricted only. True, if the user is allowed to send polls
    - `can_send_other_messages` boolean — *Optional*. Restricted only. True, if the user is allowed to send animations, games, stickers and use inline bots
    - `can_add_web_page_previews` boolean — *Optional*. Restricted only. True, if the user is allowed to add web page previews to their messages
    - `until_date` integer — *Optional*. Restricted and kicked only. Date when restrictions will be lifted for this user; unix time

## Other responses

- `default`

---

[API](https://skmtc.net/stoplight/apis/telegram-bot-api.md) · [All operations](https://skmtc.net/stoplight/apis/telegram-bot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stoplight/telegram-bot-api/versions/be4bbb34b64a/schema)