Use this method to send a group of photos

POST /sendMediaGroup

Use this method to send a group of photos, videos, documents or audios as an album. Documents and audio files can be only grouped in an album with messages of the same type. On success, an array of Messages that were sent is returned.

Body Required

chat_id integer | string Required

Any of:
integer-1 integer string-2 string

Unique identifier for the target chat or username of the target channel (in the format @channelusername)

Unique identifier for the target chat or username of the target channel (in the format @channelusername)
media array[object] Required
Any of:
InputMediaAudio array[object] InputMediaDocument array[object] InputMediaPhoto array[object] InputMediaVideo array[object]
Represents an audio file to be treated as music to be sent.
Hide attributes Show attributes

type string Required

Type of the result, must be audio

media string Required

File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://” to upload a new one using multipart/form-data under name. More info on Sending Files »

thumb string

Any of:
InputFile string-2 string

This object represents the contents of a file to be uploaded. Must be posted using multipart/form-data in the usual way that files are uploaded via the browser.

Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://” if the thumbnail was uploaded using multipart/form-data under . More info on Sending Files »

caption string

Optional. Caption of the audio to be sent, 0-1024 characters after entities parsing

parse_mode string

Optional. Mode for parsing entities in the audio caption. See formatting options for more details.

caption_entities array[object]

This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

Hide caption_entities attributes Show caption_entities attributes array[object]

type string Required

Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

offset integer Required

Offset in UTF-16 code units to the start of the entity

length integer Required

Length of the entity in UTF-16 code units

url string

Optional. For “text_link” only, url that will be opened after user taps on the text

user object

This object represents a Telegram user or bot.

Hide user attributes Show user attributes object

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 of the user's language

can_join_groups boolean

Optional. True, if the bot can be invited to groups. Returned only in getMe.

can_read_all_group_messages boolean

Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

supports_inline_queries boolean

Optional. True, if the bot supports inline queries. Returned only in getMe.

language string

Optional. For “pre” only, the programming language of the entity text

duration integer

Optional. Duration of the audio in seconds

performer string

Optional. Performer of the audio

title string

Optional. Title of the audio
Represents a general file to be sent.
Hide attributes Show attributes

type string Required

Type of the result, must be document

media string Required

File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://” to upload a new one using multipart/form-data under name. More info on Sending Files »

thumb string

Any of:
InputFile string-2 string

This object represents the contents of a file to be uploaded. Must be posted using multipart/form-data in the usual way that files are uploaded via the browser.

Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://” if the thumbnail was uploaded using multipart/form-data under . More info on Sending Files »

caption string

Optional. Caption of the document to be sent, 0-1024 characters after entities parsing

parse_mode string

Optional. Mode for parsing entities in the document caption. See formatting options for more details.

caption_entities array[object]

This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

Hide caption_entities attributes Show caption_entities attributes array[object]

type string Required

Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

offset integer Required

Offset in UTF-16 code units to the start of the entity

length integer Required

Length of the entity in UTF-16 code units

url string

Optional. For “text_link” only, url that will be opened after user taps on the text

user object

This object represents a Telegram user or bot.

Hide user attributes Show user attributes object

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 of the user's language

can_join_groups boolean

Optional. True, if the bot can be invited to groups. Returned only in getMe.

can_read_all_group_messages boolean

Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

supports_inline_queries boolean

Optional. True, if the bot supports inline queries. Returned only in getMe.

language string

Optional. For “pre” only, the programming language of the entity text

disable_content_type_detection boolean

Optional. Disables automatic server-side content type detection for files uploaded using multipart/form-data. Always true, if the document is sent as part of an album.
Represents a photo to be sent.
Hide attributes Show attributes

type string Required

Type of the result, must be photo

media string Required

File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://” to upload a new one using multipart/form-data under name. More info on Sending Files »

caption string

Optional. Caption of the photo to be sent, 0-1024 characters after entities parsing

parse_mode string

Optional. Mode for parsing entities in the photo caption. See formatting options for more details.

caption_entities array[object]

This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

Hide caption_entities attributes Show caption_entities attributes array[object]

type string Required

Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

offset integer Required

Offset in UTF-16 code units to the start of the entity

length integer Required

Length of the entity in UTF-16 code units

url string

Optional. For “text_link” only, url that will be opened after user taps on the text

user object

This object represents a Telegram user or bot.

Hide user attributes Show user attributes object

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 of the user's language

can_join_groups boolean

Optional. True, if the bot can be invited to groups. Returned only in getMe.

can_read_all_group_messages boolean

Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

supports_inline_queries boolean

Optional. True, if the bot supports inline queries. Returned only in getMe.

language string

Optional. For “pre” only, the programming language of the entity text
Represents a video to be sent.
Hide attributes Show attributes

type string Required

Type of the result, must be video

media string Required

File to send. Pass a file_id to send a file that exists on the Telegram servers (recommended), pass an HTTP URL for Telegram to get a file from the Internet, or pass “attach://” to upload a new one using multipart/form-data under name. More info on Sending Files »

thumb string

Any of:
InputFile string-2 string

This object represents the contents of a file to be uploaded. Must be posted using multipart/form-data in the usual way that files are uploaded via the browser.

Optional. Thumbnail of the file sent; can be ignored if thumbnail generation for the file is supported server-side. The thumbnail should be in JPEG format and less than 200 kB in size. A thumbnail's width and height should not exceed 320. Ignored if the file is not uploaded using multipart/form-data. Thumbnails can't be reused and can be only uploaded as a new file, so you can pass “attach://” if the thumbnail was uploaded using multipart/form-data under . More info on Sending Files »

caption string

Optional. Caption of the video to be sent, 0-1024 characters after entities parsing

parse_mode string

Optional. Mode for parsing entities in the video caption. See formatting options for more details.

caption_entities array[object]

This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.

Hide caption_entities attributes Show caption_entities attributes array[object]

type string Required

Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)

Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.

offset integer Required

Offset in UTF-16 code units to the start of the entity

length integer Required

Length of the entity in UTF-16 code units

url string

Optional. For “text_link” only, url that will be opened after user taps on the text

user object

This object represents a Telegram user or bot.

Hide user attributes Show user attributes object

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 of the user's language

can_join_groups boolean

Optional. True, if the bot can be invited to groups. Returned only in getMe.

can_read_all_group_messages boolean

Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.

supports_inline_queries boolean

Optional. True, if the bot supports inline queries. Returned only in getMe.

language string

Optional. For “pre” only, the programming language of the entity text

width integer

Optional. Video width

height integer

Optional. Video height

duration integer

Optional. Video duration

supports_streaming boolean

Optional. Pass True, if the uploaded video is suitable for streaming
disable_notification boolean

Sends messages silently. Users will receive a notification with no sound.
reply_to_message_id integer

If the messages are a reply, ID of the original message
allow_sending_without_reply boolean

Pass True, if the message should be sent even if the specified replied-to message is not found

Responses

default
Hide response attributes Show response attributes object
- ok boolean Required
  
  Default value is false.
- error_code integer Required
- description string Required
- parameters object
  
  Contains information about why a request was unsuccessful.
  
  Hide parameters attributes Show parameters attributes object
  
  migrate_to_chat_id integer
  
  Optional. The group has been migrated to a supergroup with the specified identifier. This number may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it is smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier.
  
  retry_after integer
  
  Optional. In case of exceeding flood control, the number of seconds left to wait before the request can be repeated
200
Hide response attributes Show response attributes object
- ok boolean Required
  
  Default value is true.
- result array[object] Required
  
  This object represents a message.
  
  Hide result attributes Show result attributes array[object]
  
  message_id integer Required
  
  Unique message identifier inside this chat
  
  from object
  
  This object represents a Telegram user or bot.
  
  Hide from attributes Show from attributes object
  
  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 of the user's language
  
  can_join_groups boolean
  
  Optional. True, if the bot can be invited to groups. Returned only in getMe.
  
  can_read_all_group_messages boolean
  
  Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.
  
  supports_inline_queries boolean
  
  Optional. True, if the bot supports inline queries. Returned only in getMe.
  
  sender_chat object
  
  This object represents a chat.
  
  Hide sender_chat attributes Show sender_chat attributes object
  
  id integer Required
  
  Unique identifier for this chat. This number may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it is smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier.
  
  type string Required
  
  Type of chat, can be either “private”, “group”, “supergroup” or “channel”
  
  Values are private, group, supergroup, or channel.
  
  title string
  
  Optional. Title, for supergroups, channels and group chats
  
  username string
  
  Optional. Username, for private chats, supergroups and channels if available
  
  first_name string
  
  Optional. First name of the other party in a private chat
  
  last_name string
  
  Optional. Last name of the other party in a private chat
  
  photo object
  
  This object represents a chat photo.
  
  Hide photo attributes Show photo attributes object
  
  small_file_id string Required
  
  File identifier of small (160x160) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed.
  
  small_file_unique_id string Required
  
  Unique file identifier of small (160x160) chat photo, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  big_file_id string Required
  
  File identifier of big (640x640) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed.
  
  big_file_unique_id string Required
  
  Unique file identifier of big (640x640) chat photo, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  bio string
  
  Optional. Bio of the other party in a private chat. Returned only in getChat.
  
  description string
  
  Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.
  
  invite_link string
  
  Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.
  
  pinned_message object
  
  This object represents a message.
  
  permissions object
  
  Describes actions that a non-administrator user is allowed to take in a chat.
  
  Hide permissions attributes Show permissions attributes object
  
  can_send_messages boolean
  
  Optional. True, if the user is allowed to send text messages, contacts, locations and venues
  
  can_send_media_messages boolean
  
  Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages
  
  can_send_polls boolean
  
  Optional. True, if the user is allowed to send polls, implies can_send_messages
  
  can_send_other_messages boolean
  
  Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages
  
  can_add_web_page_previews boolean
  
  Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages
  
  can_change_info boolean
  
  Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups
  
  can_invite_users boolean
  
  Optional. True, if the user is allowed to invite new users to the chat
  
  can_pin_messages boolean
  
  Optional. True, if the user is allowed to pin messages. Ignored in public supergroups
  
  slow_mode_delay integer
  
  Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.
  
  sticker_set_name string
  
  Optional. For supergroups, name of group sticker set. Returned only in getChat.
  
  can_set_sticker_set boolean
  
  Optional. True, if the bot can change the group sticker set. Returned only in getChat.
  
  linked_chat_id integer
  
  Optional. Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. This identifier may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it is smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier. Returned only in getChat.
  
  location object
  
  Represents a location to which a chat is connected.
  
  Hide location attributes Show location attributes object
  
  location object Required
  
  This object represents a point on the map.
  
  Hide location attributes Show location attributes object
  
  longitude number Required
  
  Longitude as defined by sender
  
  latitude number Required
  
  Latitude as defined by sender
  
  horizontal_accuracy number
  
  Optional. The radius of uncertainty for the location, measured in meters; 0-1500
  
  live_period integer
  
  Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.
  
  heading integer
  
  Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.
  
  proximity_alert_radius integer
  
  Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.
  
  address string Required
  
  Location address; 1-64 characters, as defined by the chat owner
  
  date integer Required
  
  Date the message was sent in Unix time
  
  chat object Required
  
  This object represents a chat.
  
  Hide chat attributes Show chat attributes object
  
  id integer Required
  
  Unique identifier for this chat. This number may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it is smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier.
  
  type string Required
  
  Type of chat, can be either “private”, “group”, “supergroup” or “channel”
  
  Values are private, group, supergroup, or channel.
  
  title string
  
  Optional. Title, for supergroups, channels and group chats
  
  username string
  
  Optional. Username, for private chats, supergroups and channels if available
  
  first_name string
  
  Optional. First name of the other party in a private chat
  
  last_name string
  
  Optional. Last name of the other party in a private chat
  
  photo object
  
  This object represents a chat photo.
  
  Hide photo attributes Show photo attributes object
  
  small_file_id string Required
  
  File identifier of small (160x160) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed.
  
  small_file_unique_id string Required
  
  Unique file identifier of small (160x160) chat photo, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  big_file_id string Required
  
  File identifier of big (640x640) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed.
  
  big_file_unique_id string Required
  
  Unique file identifier of big (640x640) chat photo, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  bio string
  
  Optional. Bio of the other party in a private chat. Returned only in getChat.
  
  description string
  
  Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.
  
  invite_link string
  
  Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.
  
  pinned_message object
  
  This object represents a message.
  
  permissions object
  
  Describes actions that a non-administrator user is allowed to take in a chat.
  
  Hide permissions attributes Show permissions attributes object
  
  can_send_messages boolean
  
  Optional. True, if the user is allowed to send text messages, contacts, locations and venues
  
  can_send_media_messages boolean
  
  Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages
  
  can_send_polls boolean
  
  Optional. True, if the user is allowed to send polls, implies can_send_messages
  
  can_send_other_messages boolean
  
  Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages
  
  can_add_web_page_previews boolean
  
  Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages
  
  can_change_info boolean
  
  Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups
  
  can_invite_users boolean
  
  Optional. True, if the user is allowed to invite new users to the chat
  
  can_pin_messages boolean
  
  Optional. True, if the user is allowed to pin messages. Ignored in public supergroups
  
  slow_mode_delay integer
  
  Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.
  
  sticker_set_name string
  
  Optional. For supergroups, name of group sticker set. Returned only in getChat.
  
  can_set_sticker_set boolean
  
  Optional. True, if the bot can change the group sticker set. Returned only in getChat.
  
  linked_chat_id integer
  
  Optional. Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. This identifier may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it is smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier. Returned only in getChat.
  
  location object
  
  Represents a location to which a chat is connected.
  
  Hide location attributes Show location attributes object
  
  location object Required
  
  This object represents a point on the map.
  
  Hide location attributes Show location attributes object
  
  longitude number Required
  
  Longitude as defined by sender
  
  latitude number Required
  
  Latitude as defined by sender
  
  horizontal_accuracy number
  
  Optional. The radius of uncertainty for the location, measured in meters; 0-1500
  
  live_period integer
  
  Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.
  
  heading integer
  
  Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.
  
  proximity_alert_radius integer
  
  Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.
  
  address string Required
  
  Location address; 1-64 characters, as defined by the chat owner
  
  forward_from object
  
  This object represents a Telegram user or bot.
  
  Hide forward_from attributes Show forward_from attributes object
  
  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 of the user's language
  
  can_join_groups boolean
  
  Optional. True, if the bot can be invited to groups. Returned only in getMe.
  
  can_read_all_group_messages boolean
  
  Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.
  
  supports_inline_queries boolean
  
  Optional. True, if the bot supports inline queries. Returned only in getMe.
  
  forward_from_chat object
  
  This object represents a chat.
  
  Hide forward_from_chat attributes Show forward_from_chat attributes object
  
  id integer Required
  
  Unique identifier for this chat. This number may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it is smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier.
  
  type string Required
  
  Type of chat, can be either “private”, “group”, “supergroup” or “channel”
  
  Values are private, group, supergroup, or channel.
  
  title string
  
  Optional. Title, for supergroups, channels and group chats
  
  username string
  
  Optional. Username, for private chats, supergroups and channels if available
  
  first_name string
  
  Optional. First name of the other party in a private chat
  
  last_name string
  
  Optional. Last name of the other party in a private chat
  
  photo object
  
  This object represents a chat photo.
  
  Hide photo attributes Show photo attributes object
  
  small_file_id string Required
  
  File identifier of small (160x160) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed.
  
  small_file_unique_id string Required
  
  Unique file identifier of small (160x160) chat photo, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  big_file_id string Required
  
  File identifier of big (640x640) chat photo. This file_id can be used only for photo download and only for as long as the photo is not changed.
  
  big_file_unique_id string Required
  
  Unique file identifier of big (640x640) chat photo, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  bio string
  
  Optional. Bio of the other party in a private chat. Returned only in getChat.
  
  description string
  
  Optional. Description, for groups, supergroups and channel chats. Returned only in getChat.
  
  invite_link string
  
  Optional. Chat invite link, for groups, supergroups and channel chats. Each administrator in a chat generates their own invite links, so the bot must first generate the link using exportChatInviteLink. Returned only in getChat.
  
  pinned_message object
  
  This object represents a message.
  
  permissions object
  
  Describes actions that a non-administrator user is allowed to take in a chat.
  
  Hide permissions attributes Show permissions attributes object
  
  can_send_messages boolean
  
  Optional. True, if the user is allowed to send text messages, contacts, locations and venues
  
  can_send_media_messages boolean
  
  Optional. True, if the user is allowed to send audios, documents, photos, videos, video notes and voice notes, implies can_send_messages
  
  can_send_polls boolean
  
  Optional. True, if the user is allowed to send polls, implies can_send_messages
  
  can_send_other_messages boolean
  
  Optional. True, if the user is allowed to send animations, games, stickers and use inline bots, implies can_send_media_messages
  
  can_add_web_page_previews boolean
  
  Optional. True, if the user is allowed to add web page previews to their messages, implies can_send_media_messages
  
  can_change_info boolean
  
  Optional. True, if the user is allowed to change the chat title, photo and other settings. Ignored in public supergroups
  
  can_invite_users boolean
  
  Optional. True, if the user is allowed to invite new users to the chat
  
  can_pin_messages boolean
  
  Optional. True, if the user is allowed to pin messages. Ignored in public supergroups
  
  slow_mode_delay integer
  
  Optional. For supergroups, the minimum allowed delay between consecutive messages sent by each unpriviledged user. Returned only in getChat.
  
  sticker_set_name string
  
  Optional. For supergroups, name of group sticker set. Returned only in getChat.
  
  can_set_sticker_set boolean
  
  Optional. True, if the bot can change the group sticker set. Returned only in getChat.
  
  linked_chat_id integer
  
  Optional. Unique identifier for the linked chat, i.e. the discussion group identifier for a channel and vice versa; for supergroups and channel chats. This identifier may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it is smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier. Returned only in getChat.
  
  location object
  
  Represents a location to which a chat is connected.
  
  Hide location attributes Show location attributes object
  
  location object Required
  
  This object represents a point on the map.
  
  Hide location attributes Show location attributes object
  
  longitude number Required
  
  Longitude as defined by sender
  
  latitude number Required
  
  Latitude as defined by sender
  
  horizontal_accuracy number
  
  Optional. The radius of uncertainty for the location, measured in meters; 0-1500
  
  live_period integer
  
  Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.
  
  heading integer
  
  Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.
  
  proximity_alert_radius integer
  
  Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.
  
  address string Required
  
  Location address; 1-64 characters, as defined by the chat owner
  
  forward_from_message_id integer
  
  Optional. For messages forwarded from channels, identifier of the original message in the channel
  
  forward_signature string
  
  Optional. For messages forwarded from channels, signature of the post author if present
  
  forward_sender_name string
  
  Optional. Sender's name for messages forwarded from users who disallow adding a link to their account in forwarded messages
  
  forward_date integer
  
  Optional. For forwarded messages, date the original message was sent in Unix time
  
  reply_to_message object
  
  This object represents a message.
  
  via_bot object
  
  This object represents a Telegram user or bot.
  
  Hide via_bot attributes Show via_bot attributes object
  
  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 of the user's language
  
  can_join_groups boolean
  
  Optional. True, if the bot can be invited to groups. Returned only in getMe.
  
  can_read_all_group_messages boolean
  
  Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.
  
  supports_inline_queries boolean
  
  Optional. True, if the bot supports inline queries. Returned only in getMe.
  
  edit_date integer
  
  Optional. Date the message was last edited in Unix time
  
  media_group_id string
  
  Optional. The unique identifier of a media message group this message belongs to
  
  author_signature string
  
  Optional. Signature of the post author for messages in channels, or the custom title of an anonymous group administrator
  
  text string
  
  Optional. For text messages, the actual UTF-8 text of the message, 0-4096 characters
  
  entities array[object]
  
  This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.
  
  Hide entities attributes Show entities attributes array[object]
  
  type string Required
  
  Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)
  
  Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.
  
  offset integer Required
  
  Offset in UTF-16 code units to the start of the entity
  
  length integer Required
  
  Length of the entity in UTF-16 code units
  
  url string
  
  Optional. For “text_link” only, url that will be opened after user taps on the text
  
  user object
  
  This object represents a Telegram user or bot.
  
  Hide user attributes Show user attributes object
  
  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 of the user's language
  
  can_join_groups boolean
  
  Optional. True, if the bot can be invited to groups. Returned only in getMe.
  
  can_read_all_group_messages boolean
  
  Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.
  
  supports_inline_queries boolean
  
  Optional. True, if the bot supports inline queries. Returned only in getMe.
  
  language string
  
  Optional. For “pre” only, the programming language of the entity text
  
  animation object
  
  This object represents an animation file (GIF or H.264/MPEG-4 AVC video without sound).
  
  Hide animation attributes Show animation attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  width integer Required
  
  Video width as defined by sender
  
  height integer Required
  
  Video height as defined by sender
  
  duration integer Required
  
  Duration of the video in seconds as defined by sender
  
  thumb object
  
  This object represents one size of a photo or a file / sticker thumbnail.
  
  Hide thumb attributes Show thumb attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  width integer Required
  
  Photo width
  
  height integer Required
  
  Photo height
  
  file_size integer
  
  Optional. File size
  
  file_name string
  
  Optional. Original animation filename as defined by sender
  
  mime_type string
  
  Optional. MIME type of the file as defined by sender
  
  file_size integer
  
  Optional. File size
  
  audio object
  
  This object represents an audio file to be treated as music by the Telegram clients.
  
  Hide audio attributes Show audio attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  duration integer Required
  
  Duration of the audio in seconds as defined by sender
  
  performer string
  
  Optional. Performer of the audio as defined by sender or by audio tags
  
  title string
  
  Optional. Title of the audio as defined by sender or by audio tags
  
  file_name string
  
  Optional. Original filename as defined by sender
  
  mime_type string
  
  Optional. MIME type of the file as defined by sender
  
  file_size integer
  
  Optional. File size
  
  thumb object
  
  This object represents one size of a photo or a file / sticker thumbnail.
  
  Hide thumb attributes Show thumb attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  width integer Required
  
  Photo width
  
  height integer Required
  
  Photo height
  
  file_size integer
  
  Optional. File size
  
  document object
  
  This object represents a general file (as opposed to photos, voice messages and audio files).
  
  Hide document attributes Show document attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  thumb object
  
  This object represents one size of a photo or a file / sticker thumbnail.
  
  Hide thumb attributes Show thumb attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  width integer Required
  
  Photo width
  
  height integer Required
  
  Photo height
  
  file_size integer
  
  Optional. File size
  
  file_name string
  
  Optional. Original filename as defined by sender
  
  mime_type string
  
  Optional. MIME type of the file as defined by sender
  
  file_size integer
  
  Optional. File size
  
  photo array[object]
  
  This object represents one size of a photo or a file / sticker thumbnail.
  
  Hide photo attributes Show photo attributes array[object]
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  width integer Required
  
  Photo width
  
  height integer Required
  
  Photo height
  
  file_size integer
  
  Optional. File size
  
  sticker object
  
  This object represents a sticker.
  
  Hide sticker attributes Show sticker attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  width integer Required
  
  Sticker width
  
  height integer Required
  
  Sticker height
  
  is_animated boolean Required
  
  True, if the sticker is animated
  
  thumb object
  
  This object represents one size of a photo or a file / sticker thumbnail.
  
  Hide thumb attributes Show thumb attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  width integer Required
  
  Photo width
  
  height integer Required
  
  Photo height
  
  file_size integer
  
  Optional. File size
  
  emoji string
  
  Optional. Emoji associated with the sticker
  
  set_name string
  
  Optional. Name of the sticker set to which the sticker belongs
  
  mask_position object
  
  This object describes the position on faces where a mask should be placed by default.
  
  Hide mask_position attributes Show mask_position attributes object
  
  point string Required
  
  The part of the face relative to which the mask should be placed. One of “forehead”, “eyes”, “mouth”, or “chin”.
  
  Values are forehead, eyes, mouth, or chin.
  
  x_shift number Required
  
  Shift by X-axis measured in widths of the mask scaled to the face size, from left to right. For example, choosing -1.0 will place mask just to the left of the default mask position.
  
  y_shift number Required
  
  Shift by Y-axis measured in heights of the mask scaled to the face size, from top to bottom. For example, 1.0 will place the mask just below the default mask position.
  
  scale number Required
  
  Mask scaling coefficient. For example, 2.0 means double size.
  
  file_size integer
  
  Optional. File size
  
  video object
  
  This object represents a video file.
  
  Hide video attributes Show video attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  width integer Required
  
  Video width as defined by sender
  
  height integer Required
  
  Video height as defined by sender
  
  duration integer Required
  
  Duration of the video in seconds as defined by sender
  
  thumb object
  
  This object represents one size of a photo or a file / sticker thumbnail.
  
  Hide thumb attributes Show thumb attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  width integer Required
  
  Photo width
  
  height integer Required
  
  Photo height
  
  file_size integer
  
  Optional. File size
  
  file_name string
  
  Optional. Original filename as defined by sender
  
  mime_type string
  
  Optional. Mime type of a file as defined by sender
  
  file_size integer
  
  Optional. File size
  
  video_note object
  
  This object represents a video message (available in Telegram apps as of v.4.0).
  
  Hide video_note attributes Show video_note attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  length integer Required
  
  Video width and height (diameter of the video message) as defined by sender
  
  duration integer Required
  
  Duration of the video in seconds as defined by sender
  
  thumb object
  
  This object represents one size of a photo or a file / sticker thumbnail.
  
  Hide thumb attributes Show thumb attributes object
  
  height integer Required
  
  Photo height
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  width integer Required
  
  Photo width
  
  file_size integer
  
  Optional. File size
  
  file_size integer
  
  Optional. File size
  
  voice object
  
  This object represents a voice note.
  
  Hide voice attributes Show voice attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  duration integer Required
  
  Duration of the audio in seconds as defined by sender
  
  mime_type string
  
  Optional. MIME type of the file as defined by sender
  
  file_size integer
  
  Optional. File size
  
  caption string
  
  Optional. Caption for the animation, audio, document, photo, video or voice, 0-1024 characters
  
  caption_entities array[object]
  
  This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.
  
  Hide caption_entities attributes Show caption_entities attributes array[object]
  
  type string Required
  
  Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)
  
  Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.
  
  offset integer Required
  
  Offset in UTF-16 code units to the start of the entity
  
  length integer Required
  
  Length of the entity in UTF-16 code units
  
  url string
  
  Optional. For “text_link” only, url that will be opened after user taps on the text
  
  user object
  
  This object represents a Telegram user or bot.
  
  Hide user attributes Show user attributes object
  
  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 of the user's language
  
  can_join_groups boolean
  
  Optional. True, if the bot can be invited to groups. Returned only in getMe.
  
  can_read_all_group_messages boolean
  
  Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.
  
  supports_inline_queries boolean
  
  Optional. True, if the bot supports inline queries. Returned only in getMe.
  
  language string
  
  Optional. For “pre” only, the programming language of the entity text
  
  contact object
  
  This object represents a phone contact.
  
  Hide contact attributes Show contact attributes object
  
  phone_number string Required
  
  Contact's phone number
  
  first_name string Required
  
  Contact's first name
  
  last_name string
  
  Optional. Contact's last name
  
  user_id integer
  
  Optional. Contact's user identifier in Telegram
  
  vcard string
  
  Optional. Additional data about the contact in the form of a vCard
  
  dice object
  
  This object represents an animated emoji that displays a random value.
  
  Hide dice attributes Show dice attributes object
  
  emoji string Required
  
  Emoji on which the dice throw animation is based
  
  value integer Required
  
  Value of the dice, 1-6 for “” and “” base emoji, 1-5 for “” and “” base emoji, 1-64 for “” base emoji
  
  game object
  
  This object represents a game. Use BotFather to create and edit games, their short names will act as unique identifiers.
  
  Hide game attributes Show game attributes object
  
  title string Required
  
  Title of the game
  
  description string Required
  
  Description of the game
  
  photo array[object] Required
  
  This object represents one size of a photo or a file / sticker thumbnail.
  
  Hide photo attributes Show photo attributes array[object]
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  width integer Required
  
  Photo width
  
  height integer Required
  
  Photo height
  
  file_size integer
  
  Optional. File size
  
  text string
  
  Optional. Brief description of the game or high scores included in the game message. Can be automatically edited to include current high scores for the game when the bot calls setGameScore, or manually edited using editMessageText. 0-4096 characters.
  
  text_entities array[object]
  
  This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.
  
  Hide text_entities attributes Show text_entities attributes array[object]
  
  type string Required
  
  Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)
  
  Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.
  
  offset integer Required
  
  Offset in UTF-16 code units to the start of the entity
  
  length integer Required
  
  Length of the entity in UTF-16 code units
  
  url string
  
  Optional. For “text_link” only, url that will be opened after user taps on the text
  
  user object
  
  This object represents a Telegram user or bot.
  
  Hide user attributes Show user attributes object
  
  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 of the user's language
  
  can_join_groups boolean
  
  Optional. True, if the bot can be invited to groups. Returned only in getMe.
  
  can_read_all_group_messages boolean
  
  Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.
  
  supports_inline_queries boolean
  
  Optional. True, if the bot supports inline queries. Returned only in getMe.
  
  language string
  
  Optional. For “pre” only, the programming language of the entity text
  
  animation object
  
  This object represents an animation file (GIF or H.264/MPEG-4 AVC video without sound).
  
  Hide animation attributes Show animation attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  width integer Required
  
  Video width as defined by sender
  
  height integer Required
  
  Video height as defined by sender
  
  duration integer Required
  
  Duration of the video in seconds as defined by sender
  
  thumb object
  
  This object represents one size of a photo or a file / sticker thumbnail.
  
  Hide thumb attributes Show thumb attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  width integer Required
  
  Photo width
  
  height integer Required
  
  Photo height
  
  file_size integer
  
  Optional. File size
  
  file_name string
  
  Optional. Original animation filename as defined by sender
  
  mime_type string
  
  Optional. MIME type of the file as defined by sender
  
  file_size integer
  
  Optional. File size
  
  poll object
  
  This object contains information about a poll.
  
  Hide poll attributes Show poll attributes object
  
  id string Required
  
  Unique poll identifier
  
  question string Required
  
  Poll question, 1-255 characters
  
  options array[object] Required
  
  This object contains information about one answer option in a poll.
  
  Hide options attributes Show options attributes array[object]
  
  text string Required
  
  Option text, 1-100 characters
  
  voter_count integer Required
  
  Number of users that voted for this option
  
  total_voter_count integer Required
  
  Total number of users that voted in the poll
  
  is_closed boolean Required
  
  True, if the poll is closed
  
  is_anonymous boolean Required
  
  True, if the poll is anonymous
  
  type string Required
  
  Poll type, currently can be “regular” or “quiz”
  
  allows_multiple_answers boolean Required
  
  True, if the poll allows multiple answers
  
  correct_option_id integer
  
  Optional. 0-based identifier of the correct answer option. Available only for polls in the quiz mode, which are closed, or was sent (not forwarded) by the bot or to the private chat with the bot.
  
  explanation string
  
  Optional. Text that is shown when a user chooses an incorrect answer or taps on the lamp icon in a quiz-style poll, 0-200 characters
  
  explanation_entities array[object]
  
  This object represents one special entity in a text message. For example, hashtags, usernames, URLs, etc.
  
  Hide explanation_entities attributes Show explanation_entities attributes array[object]
  
  type string Required
  
  Type of the entity. Can be “mention” (@username), “hashtag” (#hashtag), “cashtag” ($USD), “bot_command” (/start@jobs_bot), “url” (https://telegram.org), “email” (do-not-reply@telegram.org), “phone_number” (+1-212-555-0123), “bold” (bold text), “italic” (italic text), “underline” (underlined text), “strikethrough” (strikethrough text), “code” (monowidth string), “pre” (monowidth block), “text_link” (for clickable text URLs), “text_mention” (for users without usernames)
  
  Values are mention, hashtag, cashtag, bot_command, url, email, phone_number, bold, italic, underline, strikethrough, code, pre, text_link, or text_mention.
  
  offset integer Required
  
  Offset in UTF-16 code units to the start of the entity
  
  length integer Required
  
  Length of the entity in UTF-16 code units
  
  url string
  
  Optional. For “text_link” only, url that will be opened after user taps on the text
  
  user object
  
  This object represents a Telegram user or bot.
  
  Hide user attributes Show user attributes object
  
  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 of the user's language
  
  can_join_groups boolean
  
  Optional. True, if the bot can be invited to groups. Returned only in getMe.
  
  can_read_all_group_messages boolean
  
  Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.
  
  supports_inline_queries boolean
  
  Optional. True, if the bot supports inline queries. Returned only in getMe.
  
  language string
  
  Optional. For “pre” only, the programming language of the entity text
  
  open_period integer
  
  Optional. Amount of time in seconds the poll will be active after creation
  
  close_date integer
  
  Optional. Point in time (Unix timestamp) when the poll will be automatically closed
  
  venue object
  
  This object represents a venue.
  
  Hide venue attributes Show venue attributes object
  
  location object Required
  
  This object represents a point on the map.
  
  Hide location attributes Show location attributes object
  
  longitude number Required
  
  Longitude as defined by sender
  
  latitude number Required
  
  Latitude as defined by sender
  
  horizontal_accuracy number
  
  Optional. The radius of uncertainty for the location, measured in meters; 0-1500
  
  live_period integer
  
  Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.
  
  heading integer
  
  Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.
  
  proximity_alert_radius integer
  
  Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.
  
  foursquare_id string
  
  Optional. Foursquare identifier of the venue
  
  title string Required
  
  Name of the venue
  
  address string Required
  
  Address of the venue
  
  foursquare_type string
  
  Optional. Foursquare type of the venue. (For example, “arts_entertainment/default”, “arts_entertainment/aquarium” or “food/icecream”.)
  
  google_place_id string
  
  Optional. Google Places identifier of the venue
  
  google_place_type string
  
  Optional. Google Places type of the venue. (See supported types.)
  
  location object
  
  This object represents a point on the map.
  
  Hide location attributes Show location attributes object
  
  longitude number Required
  
  Longitude as defined by sender
  
  latitude number Required
  
  Latitude as defined by sender
  
  horizontal_accuracy number
  
  Optional. The radius of uncertainty for the location, measured in meters; 0-1500
  
  live_period integer
  
  Optional. Time relative to the message sending date, during which the location can be updated, in seconds. For active live locations only.
  
  heading integer
  
  Optional. The direction in which user is moving, in degrees; 1-360. For active live locations only.
  
  proximity_alert_radius integer
  
  Optional. Maximum distance for proximity alerts about approaching another chat member, in meters. For sent live locations only.
  
  new_chat_members array[object]
  
  This object represents a Telegram user or bot.
  
  Hide new_chat_members attributes Show new_chat_members attributes array[object]
  
  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 of the user's language
  
  can_join_groups boolean
  
  Optional. True, if the bot can be invited to groups. Returned only in getMe.
  
  can_read_all_group_messages boolean
  
  Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.
  
  supports_inline_queries boolean
  
  Optional. True, if the bot supports inline queries. Returned only in getMe.
  
  left_chat_member object
  
  This object represents a Telegram user or bot.
  
  Hide left_chat_member attributes Show left_chat_member attributes object
  
  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 of the user's language
  
  can_join_groups boolean
  
  Optional. True, if the bot can be invited to groups. Returned only in getMe.
  
  can_read_all_group_messages boolean
  
  Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.
  
  supports_inline_queries boolean
  
  Optional. True, if the bot supports inline queries. Returned only in getMe.
  
  new_chat_title string
  
  Optional. A chat title was changed to this value
  
  new_chat_photo array[object]
  
  This object represents one size of a photo or a file / sticker thumbnail.
  
  Hide new_chat_photo attributes Show new_chat_photo attributes array[object]
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  width integer Required
  
  Photo width
  
  height integer Required
  
  Photo height
  
  file_size integer
  
  Optional. File size
  
  delete_chat_photo boolean
  
  Optional. Service message: the chat photo was deleted
  
  group_chat_created boolean
  
  Optional. Service message: the group has been created
  
  supergroup_chat_created boolean
  
  Optional. Service message: the supergroup has been created. This field can't be received in a message coming through updates, because bot can't be a member of a supergroup when it is created. It can only be found in reply_to_message if someone replies to a very first message in a directly created supergroup.
  
  channel_chat_created boolean
  
  Optional. Service message: the channel has been created. This field can't be received in a message coming through updates, because bot can't be a member of a channel when it is created. It can only be found in reply_to_message if someone replies to a very first message in a channel.
  
  migrate_to_chat_id integer
  
  Optional. The group has been migrated to a supergroup with the specified identifier. This number may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it is smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier.
  
  migrate_from_chat_id integer
  
  Optional. The supergroup has been migrated from a group with the specified identifier. This number may be greater than 32 bits and some programming languages may have difficulty/silent defects in interpreting it. But it is smaller than 52 bits, so a signed 64 bit integer or double-precision float type are safe for storing this identifier.
  
  pinned_message object
  
  This object represents a message.
  
  invoice object
  
  This object contains basic information about an invoice.
  
  Hide invoice attributes Show invoice attributes object
  
  title string Required
  
  Product name
  
  description string Required
  
  Product description
  
  start_parameter string Required
  
  Unique bot deep-linking parameter that can be used to generate this invoice
  
  currency string Required
  
  Three-letter ISO 4217 currency code
  
  total_amount integer Required
  
  Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass amount = 145. See the exp parameter in currencies.json, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).
  
  successful_payment object
  
  This object contains basic information about a successful payment.
  
  Hide successful_payment attributes Show successful_payment attributes object
  
  currency string Required
  
  Three-letter ISO 4217 currency code
  
  total_amount integer Required
  
  Total price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45 pass amount = 145. See the exp parameter in currencies.json, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).
  
  invoice_payload string Required
  
  Bot specified invoice payload
  
  shipping_option_id string
  
  Optional. Identifier of the shipping option chosen by the user
  
  order_info object
  
  This object represents information about an order.
  
  Hide order_info attributes Show order_info attributes object
  
  name string
  
  Optional. User name
  
  phone_number string
  
  Optional. User's phone number
  
  email string
  
  Optional. User email
  
  shipping_address object
  
  This object represents a shipping address.
  
  Hide shipping_address attributes Show shipping_address attributes object
  
  country_code string Required
  
  ISO 3166-1 alpha-2 country code
  
  state string Required
  
  State, if applicable
  
  city string Required
  
  City
  
  street_line1 string Required
  
  First line for the address
  
  street_line2 string Required
  
  Second line for the address
  
  post_code string Required
  
  Address post code
  
  telegram_payment_charge_id string Required
  
  Telegram payment identifier
  
  provider_payment_charge_id string Required
  
  Provider payment identifier
  
  connected_website string
  
  Optional. The domain name of the website on which the user has logged in. More about Telegram Login »
  
  passport_data object
  
  Contains information about Telegram Passport data shared with the bot by the user.
  
  Hide passport_data attributes Show passport_data attributes object
  
  data array[object] Required
  
  Contains information about documents or other Telegram Passport elements shared with the bot by the user.
  
  Hide data attributes Show data attributes array[object]
  
  type string Required
  
  Element type. One of “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport”, “address”, “utility_bill”, “bank_statement”, “rental_agreement”, “passport_registration”, “temporary_registration”, “phone_number”, “email”.
  
  Values are personal_details, passport, driver_license, identity_card, internal_passport, address, utility_bill, bank_statement, rental_agreement, passport_registration, temporary_registration, phone_number, or email.
  
  data string
  
  Optional. Base64-encoded encrypted Telegram Passport element data provided by the user, available for “personal_details”, “passport”, “driver_license”, “identity_card”, “internal_passport” and “address” types. Can be decrypted and verified using the accompanying EncryptedCredentials.
  
  phone_number string
  
  Optional. User's verified phone number, available only for “phone_number” type
  
  email string
  
  Optional. User's verified email address, available only for “email” type
  
  files array[object]
  
  This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.
  
  Hide files attributes Show files attributes array[object]
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  file_size integer Required
  
  File size
  
  file_date integer Required
  
  Unix time when the file was uploaded
  
  front_side object
  
  This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.
  
  Hide front_side attributes Show front_side attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  file_size integer Required
  
  File size
  
  file_date integer Required
  
  Unix time when the file was uploaded
  
  reverse_side object
  
  This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.
  
  Hide reverse_side attributes Show reverse_side attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  file_size integer Required
  
  File size
  
  file_date integer Required
  
  Unix time when the file was uploaded
  
  selfie object
  
  This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.
  
  Hide selfie attributes Show selfie attributes object
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  file_size integer Required
  
  File size
  
  file_date integer Required
  
  Unix time when the file was uploaded
  
  translation array[object]
  
  This object represents a file uploaded to Telegram Passport. Currently all Telegram Passport files are in JPEG format when decrypted and don't exceed 10MB.
  
  Hide translation attributes Show translation attributes array[object]
  
  file_id string Required
  
  Identifier for this file, which can be used to download or reuse the file
  
  file_unique_id string Required
  
  Unique identifier for this file, which is supposed to be the same over time and for different bots. Can't be used to download or reuse the file.
  
  file_size integer Required
  
  File size
  
  file_date integer Required
  
  Unix time when the file was uploaded
  
  hash string Required
  
  Base64-encoded element hash for using in PassportElementErrorUnspecified
  
  credentials object Required
  
  Contains data required for decrypting and authenticating EncryptedPassportElement. See the Telegram Passport Documentation for a complete description of the data decryption and authentication processes.
  
  Hide credentials attributes Show credentials attributes object
  
  data string Required
  
  Base64-encoded encrypted JSON-serialized data with unique user's payload, data hashes and secrets required for EncryptedPassportElement decryption and authentication
  
  hash string Required
  
  Base64-encoded data hash for data authentication
  
  secret string Required
  
  Base64-encoded secret, encrypted with the bot's public RSA key, required for data decryption
  
  proximity_alert_triggered object
  
  This object represents the content of a service message, sent whenever a user in the chat triggers a proximity alert set by another user.
  
  Hide proximity_alert_triggered attributes Show proximity_alert_triggered attributes object
  
  traveler object Required
  
  This object represents a Telegram user or bot.
  
  Hide traveler attributes Show traveler attributes object
  
  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 of the user's language
  
  can_join_groups boolean
  
  Optional. True, if the bot can be invited to groups. Returned only in getMe.
  
  can_read_all_group_messages boolean
  
  Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.
  
  supports_inline_queries boolean
  
  Optional. True, if the bot supports inline queries. Returned only in getMe.
  
  watcher object Required
  
  This object represents a Telegram user or bot.
  
  Hide watcher attributes Show watcher attributes object
  
  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 of the user's language
  
  can_join_groups boolean
  
  Optional. True, if the bot can be invited to groups. Returned only in getMe.
  
  can_read_all_group_messages boolean
  
  Optional. True, if privacy mode is disabled for the bot. Returned only in getMe.
  
  supports_inline_queries boolean
  
  Optional. True, if the bot supports inline queries. Returned only in getMe.
  
  distance integer Required
  
  The distance between the users
  
  reply_markup object
  
  This object represents an inline keyboard that appears right next to the message it belongs to.
  
  Hide reply_markup attribute Show reply_markup attribute object
  
  Array of button rows, each represented by an Array of InlineKeyboardButton objects

POST /sendMediaGroup

curl \
 -X POST https://api.telegram.org/bot123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11/sendMediaGroup \
 -H "Content-Type: multipart/form-data" \
 -F "chat_id=42" \
 -F "media[]={"type"=>"string", "media"=>"string", "caption"=>"string", "parse_mode"=>"string", "caption_entities"=>[{"type"=>"mention", "offset"=>42, "length"=>42, "url"=>"string", "user"=>{"id"=>42, "is_bot"=>true, "first_name"=>"string", "last_name"=>"string", "username"=>"string", "language_code"=>"string", "can_join_groups"=>true, "can_read_all_group_messages"=>true, "supports_inline_queries"=>true}, "language"=>"string"}], "duration"=>42, "performer"=>"string", "title"=>"string"}" \
 -F "disable_notification=true" \
 -F "reply_to_message_id=42" \
 -F "allow_sending_without_reply=true"

Request example

{
  "chat_id": 42,
  "media": [
    {
      "type": "string",
      "media": "string",
      "caption": "string",
      "parse_mode": "string",
      "caption_entities": [
        {
          "type": "mention",
          "offset": 42,
          "length": 42,
          "url": "string",
          "user": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "language": "string"
        }
      ],
      "duration": 42,
      "performer": "string",
      "title": "string"
    }
  ],
  "disable_notification": true,
  "reply_to_message_id": 42,
  "allow_sending_without_reply": true
}

Request examples

{
  "chat_id": 42,
  "media": [
    {
      "type": "string",
      "media": "string",
      "caption": "string",
      "parse_mode": "string",
      "caption_entities": [
        {
          "type": "mention",
          "offset": 42,
          "length": 42,
          "url": "string",
          "user": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "language": "string"
        }
      ],
      "duration": 42,
      "performer": "string",
      "title": "string"
    }
  ],
  "disable_notification": true,
  "reply_to_message_id": 42,
  "allow_sending_without_reply": true
}

Response examples (default)

{
  "ok": false,
  "error_code": 42,
  "description": "string",
  "parameters": {
    "migrate_to_chat_id": 42,
    "retry_after": 42
  }
}

Response examples (default)

{
  "ok": false,
  "error_code": 42,
  "description": "string",
  "parameters": {
    "migrate_to_chat_id": 42,
    "retry_after": 42
  }
}

Response examples (200)

{
  "ok": true,
  "result": [
    {
      "message_id": 42,
      "from": {
        "id": 42,
        "is_bot": true,
        "first_name": "string",
        "last_name": "string",
        "username": "string",
        "language_code": "string",
        "can_join_groups": true,
        "can_read_all_group_messages": true,
        "supports_inline_queries": true
      },
      "sender_chat": {
        "id": 42,
        "type": "private",
        "title": "string",
        "username": "string",
        "first_name": "string",
        "last_name": "string",
        "photo": {
          "small_file_id": "string",
          "small_file_unique_id": "string",
          "big_file_id": "string",
          "big_file_unique_id": "string"
        },
        "bio": "string",
        "description": "string",
        "invite_link": "string",
        "pinned_message": {},
        "permissions": {
          "can_send_messages": true,
          "can_send_media_messages": true,
          "can_send_polls": true,
          "can_send_other_messages": true,
          "can_add_web_page_previews": true,
          "can_change_info": true,
          "can_invite_users": true,
          "can_pin_messages": true
        },
        "slow_mode_delay": 42,
        "sticker_set_name": "string",
        "can_set_sticker_set": true,
        "linked_chat_id": 42,
        "location": {
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "address": "string"
        }
      },
      "date": 42,
      "chat": {
        "id": 42,
        "type": "private",
        "title": "string",
        "username": "string",
        "first_name": "string",
        "last_name": "string",
        "photo": {
          "small_file_id": "string",
          "small_file_unique_id": "string",
          "big_file_id": "string",
          "big_file_unique_id": "string"
        },
        "bio": "string",
        "description": "string",
        "invite_link": "string",
        "pinned_message": {},
        "permissions": {
          "can_send_messages": true,
          "can_send_media_messages": true,
          "can_send_polls": true,
          "can_send_other_messages": true,
          "can_add_web_page_previews": true,
          "can_change_info": true,
          "can_invite_users": true,
          "can_pin_messages": true
        },
        "slow_mode_delay": 42,
        "sticker_set_name": "string",
        "can_set_sticker_set": true,
        "linked_chat_id": 42,
        "location": {
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "address": "string"
        }
      },
      "forward_from": {
        "id": 42,
        "is_bot": true,
        "first_name": "string",
        "last_name": "string",
        "username": "string",
        "language_code": "string",
        "can_join_groups": true,
        "can_read_all_group_messages": true,
        "supports_inline_queries": true
      },
      "forward_from_chat": {
        "id": 42,
        "type": "private",
        "title": "string",
        "username": "string",
        "first_name": "string",
        "last_name": "string",
        "photo": {
          "small_file_id": "string",
          "small_file_unique_id": "string",
          "big_file_id": "string",
          "big_file_unique_id": "string"
        },
        "bio": "string",
        "description": "string",
        "invite_link": "string",
        "pinned_message": {},
        "permissions": {
          "can_send_messages": true,
          "can_send_media_messages": true,
          "can_send_polls": true,
          "can_send_other_messages": true,
          "can_add_web_page_previews": true,
          "can_change_info": true,
          "can_invite_users": true,
          "can_pin_messages": true
        },
        "slow_mode_delay": 42,
        "sticker_set_name": "string",
        "can_set_sticker_set": true,
        "linked_chat_id": 42,
        "location": {
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "address": "string"
        }
      },
      "forward_from_message_id": 42,
      "forward_signature": "string",
      "forward_sender_name": "string",
      "forward_date": 42,
      "reply_to_message": {},
      "via_bot": {
        "id": 42,
        "is_bot": true,
        "first_name": "string",
        "last_name": "string",
        "username": "string",
        "language_code": "string",
        "can_join_groups": true,
        "can_read_all_group_messages": true,
        "supports_inline_queries": true
      },
      "edit_date": 42,
      "media_group_id": "string",
      "author_signature": "string",
      "text": "string",
      "entities": [
        {
          "type": "mention",
          "offset": 42,
          "length": 42,
          "url": "string",
          "user": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "language": "string"
        }
      ],
      "animation": {
        "file_id": "string",
        "file_unique_id": "string",
        "width": 42,
        "height": 42,
        "duration": 42,
        "thumb": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "file_size": 42
        },
        "file_name": "string",
        "mime_type": "string",
        "file_size": 42
      },
      "audio": {
        "file_id": "string",
        "file_unique_id": "string",
        "duration": 42,
        "performer": "string",
        "title": "string",
        "file_name": "string",
        "mime_type": "string",
        "file_size": 42,
        "thumb": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "file_size": 42
        }
      },
      "document": {
        "file_id": "string",
        "file_unique_id": "string",
        "thumb": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "file_size": 42
        },
        "file_name": "string",
        "mime_type": "string",
        "file_size": 42
      },
      "photo": [
        {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "file_size": 42
        }
      ],
      "sticker": {
        "file_id": "string",
        "file_unique_id": "string",
        "width": 42,
        "height": 42,
        "is_animated": true,
        "thumb": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "file_size": 42
        },
        "emoji": "string",
        "set_name": "string",
        "mask_position": {
          "point": "forehead",
          "x_shift": 42.0,
          "y_shift": 42.0,
          "scale": 42.0
        },
        "file_size": 42
      },
      "video": {
        "file_id": "string",
        "file_unique_id": "string",
        "width": 42,
        "height": 42,
        "duration": 42,
        "thumb": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "file_size": 42
        },
        "file_name": "string",
        "mime_type": "string",
        "file_size": 42
      },
      "video_note": {
        "file_id": "string",
        "file_unique_id": "string",
        "length": 42,
        "duration": 42,
        "thumb": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "file_size": 42
        },
        "file_size": 42
      },
      "voice": {
        "file_id": "string",
        "file_unique_id": "string",
        "duration": 42,
        "mime_type": "string",
        "file_size": 42
      },
      "caption": "string",
      "caption_entities": [
        {
          "type": "mention",
          "offset": 42,
          "length": 42,
          "url": "string",
          "user": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "language": "string"
        }
      ],
      "contact": {
        "phone_number": "string",
        "first_name": "string",
        "last_name": "string",
        "user_id": 42,
        "vcard": "string"
      },
      "dice": {
        "emoji": "string",
        "value": 42
      },
      "game": {
        "title": "string",
        "description": "string",
        "photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "text": "string",
        "text_entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "animation": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        }
      },
      "poll": {
        "id": "string",
        "question": "string",
        "options": [
          {
            "text": "string",
            "voter_count": 42
          }
        ],
        "total_voter_count": 42,
        "is_closed": true,
        "is_anonymous": true,
        "type": "string",
        "allows_multiple_answers": true,
        "correct_option_id": 42,
        "explanation": "string",
        "explanation_entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "open_period": 42,
        "close_date": 42
      },
      "venue": {
        "location": {
          "longitude": 42.0,
          "latitude": 42.0,
          "horizontal_accuracy": 42.0,
          "live_period": 42,
          "heading": 42,
          "proximity_alert_radius": 42
        },
        "title": "string",
        "address": "string",
        "foursquare_id": "string",
        "foursquare_type": "string",
        "google_place_id": "string",
        "google_place_type": "string"
      },
      "location": {
        "longitude": 42.0,
        "latitude": 42.0,
        "horizontal_accuracy": 42.0,
        "live_period": 42,
        "heading": 42,
        "proximity_alert_radius": 42
      },
      "new_chat_members": [
        {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        }
      ],
      "left_chat_member": {
        "id": 42,
        "is_bot": true,
        "first_name": "string",
        "last_name": "string",
        "username": "string",
        "language_code": "string",
        "can_join_groups": true,
        "can_read_all_group_messages": true,
        "supports_inline_queries": true
      },
      "new_chat_title": "string",
      "new_chat_photo": [
        {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "file_size": 42
        }
      ],
      "delete_chat_photo": true,
      "group_chat_created": true,
      "supergroup_chat_created": true,
      "channel_chat_created": true,
      "migrate_to_chat_id": 42,
      "migrate_from_chat_id": 42,
      "pinned_message": {},
      "invoice": {
        "title": "string",
        "description": "string",
        "start_parameter": "string",
        "currency": "string",
        "total_amount": 42
      },
      "successful_payment": {
        "currency": "string",
        "total_amount": 42,
        "invoice_payload": "string",
        "shipping_option_id": "string",
        "order_info": {
          "name": "string",
          "phone_number": "string",
          "email": "string",
          "shipping_address": {
            "country_code": "string",
            "state": "string",
            "city": "string",
            "street_line1": "string",
            "street_line2": "string",
            "post_code": "string"
          }
        },
        "telegram_payment_charge_id": "string",
        "provider_payment_charge_id": "string"
      },
      "connected_website": "string",
      "passport_data": {
        "data": [
          {
            "type": "personal_details",
            "data": "string",
            "phone_number": "string",
            "email": "string",
            "files": [
              {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              }
            ],
            "front_side": {
              "file_id": "string",
              "file_unique_id": "string",
              "file_size": 42,
              "file_date": 42
            },
            "reverse_side": {
              "file_id": "string",
              "file_unique_id": "string",
              "file_size": 42,
              "file_date": 42
            },
            "selfie": {
              "file_id": "string",
              "file_unique_id": "string",
              "file_size": 42,
              "file_date": 42
            },
            "translation": [
              {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              }
            ],
            "hash": "string"
          }
        ],
        "credentials": {
          "data": "string",
          "hash": "string",
          "secret": "string"
        }
      },
      "proximity_alert_triggered": {
        "traveler": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "watcher": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "distance": 42
      },
      "reply_markup": {
        "": [
          [
            {}
          ]
        ]
      }
    }
  ]
}

Response examples (200)

{
  "ok": true,
  "result": [
    {
      "message_id": 42,
      "from": {
        "id": 42,
        "is_bot": true,
        "first_name": "string",
        "last_name": "string",
        "username": "string",
        "language_code": "string",
        "can_join_groups": true,
        "can_read_all_group_messages": true,
        "supports_inline_queries": true
      },
      "sender_chat": {
        "id": 42,
        "type": "private",
        "title": "string",
        "username": "string",
        "first_name": "string",
        "last_name": "string",
        "photo": {
          "small_file_id": "string",
          "small_file_unique_id": "string",
          "big_file_id": "string",
          "big_file_unique_id": "string"
        },
        "bio": "string",
        "description": "string",
        "invite_link": "string",
        "pinned_message": {},
        "permissions": {
          "can_send_messages": true,
          "can_send_media_messages": true,
          "can_send_polls": true,
          "can_send_other_messages": true,
          "can_add_web_page_previews": true,
          "can_change_info": true,
          "can_invite_users": true,
          "can_pin_messages": true
        },
        "slow_mode_delay": 42,
        "sticker_set_name": "string",
        "can_set_sticker_set": true,
        "linked_chat_id": 42,
        "location": {
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "address": "string"
        }
      },
      "date": 42,
      "chat": {
        "id": 42,
        "type": "private",
        "title": "string",
        "username": "string",
        "first_name": "string",
        "last_name": "string",
        "photo": {
          "small_file_id": "string",
          "small_file_unique_id": "string",
          "big_file_id": "string",
          "big_file_unique_id": "string"
        },
        "bio": "string",
        "description": "string",
        "invite_link": "string",
        "pinned_message": {},
        "permissions": {
          "can_send_messages": true,
          "can_send_media_messages": true,
          "can_send_polls": true,
          "can_send_other_messages": true,
          "can_add_web_page_previews": true,
          "can_change_info": true,
          "can_invite_users": true,
          "can_pin_messages": true
        },
        "slow_mode_delay": 42,
        "sticker_set_name": "string",
        "can_set_sticker_set": true,
        "linked_chat_id": 42,
        "location": {
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "address": "string"
        }
      },
      "forward_from": {
        "id": 42,
        "is_bot": true,
        "first_name": "string",
        "last_name": "string",
        "username": "string",
        "language_code": "string",
        "can_join_groups": true,
        "can_read_all_group_messages": true,
        "supports_inline_queries": true
      },
      "forward_from_chat": {
        "id": 42,
        "type": "private",
        "title": "string",
        "username": "string",
        "first_name": "string",
        "last_name": "string",
        "photo": {
          "small_file_id": "string",
          "small_file_unique_id": "string",
          "big_file_id": "string",
          "big_file_unique_id": "string"
        },
        "bio": "string",
        "description": "string",
        "invite_link": "string",
        "pinned_message": {},
        "permissions": {
          "can_send_messages": true,
          "can_send_media_messages": true,
          "can_send_polls": true,
          "can_send_other_messages": true,
          "can_add_web_page_previews": true,
          "can_change_info": true,
          "can_invite_users": true,
          "can_pin_messages": true
        },
        "slow_mode_delay": 42,
        "sticker_set_name": "string",
        "can_set_sticker_set": true,
        "linked_chat_id": 42,
        "location": {
          "location": {
            "longitude": 42.0,
            "latitude": 42.0,
            "horizontal_accuracy": 42.0,
            "live_period": 42,
            "heading": 42,
            "proximity_alert_radius": 42
          },
          "address": "string"
        }
      },
      "forward_from_message_id": 42,
      "forward_signature": "string",
      "forward_sender_name": "string",
      "forward_date": 42,
      "reply_to_message": {},
      "via_bot": {
        "id": 42,
        "is_bot": true,
        "first_name": "string",
        "last_name": "string",
        "username": "string",
        "language_code": "string",
        "can_join_groups": true,
        "can_read_all_group_messages": true,
        "supports_inline_queries": true
      },
      "edit_date": 42,
      "media_group_id": "string",
      "author_signature": "string",
      "text": "string",
      "entities": [
        {
          "type": "mention",
          "offset": 42,
          "length": 42,
          "url": "string",
          "user": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "language": "string"
        }
      ],
      "animation": {
        "file_id": "string",
        "file_unique_id": "string",
        "width": 42,
        "height": 42,
        "duration": 42,
        "thumb": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "file_size": 42
        },
        "file_name": "string",
        "mime_type": "string",
        "file_size": 42
      },
      "audio": {
        "file_id": "string",
        "file_unique_id": "string",
        "duration": 42,
        "performer": "string",
        "title": "string",
        "file_name": "string",
        "mime_type": "string",
        "file_size": 42,
        "thumb": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "file_size": 42
        }
      },
      "document": {
        "file_id": "string",
        "file_unique_id": "string",
        "thumb": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "file_size": 42
        },
        "file_name": "string",
        "mime_type": "string",
        "file_size": 42
      },
      "photo": [
        {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "file_size": 42
        }
      ],
      "sticker": {
        "file_id": "string",
        "file_unique_id": "string",
        "width": 42,
        "height": 42,
        "is_animated": true,
        "thumb": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "file_size": 42
        },
        "emoji": "string",
        "set_name": "string",
        "mask_position": {
          "point": "forehead",
          "x_shift": 42.0,
          "y_shift": 42.0,
          "scale": 42.0
        },
        "file_size": 42
      },
      "video": {
        "file_id": "string",
        "file_unique_id": "string",
        "width": 42,
        "height": 42,
        "duration": 42,
        "thumb": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "file_size": 42
        },
        "file_name": "string",
        "mime_type": "string",
        "file_size": 42
      },
      "video_note": {
        "file_id": "string",
        "file_unique_id": "string",
        "length": 42,
        "duration": 42,
        "thumb": {
          "height": 42,
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "file_size": 42
        },
        "file_size": 42
      },
      "voice": {
        "file_id": "string",
        "file_unique_id": "string",
        "duration": 42,
        "mime_type": "string",
        "file_size": 42
      },
      "caption": "string",
      "caption_entities": [
        {
          "type": "mention",
          "offset": 42,
          "length": 42,
          "url": "string",
          "user": {
            "id": 42,
            "is_bot": true,
            "first_name": "string",
            "last_name": "string",
            "username": "string",
            "language_code": "string",
            "can_join_groups": true,
            "can_read_all_group_messages": true,
            "supports_inline_queries": true
          },
          "language": "string"
        }
      ],
      "contact": {
        "phone_number": "string",
        "first_name": "string",
        "last_name": "string",
        "user_id": 42,
        "vcard": "string"
      },
      "dice": {
        "emoji": "string",
        "value": 42
      },
      "game": {
        "title": "string",
        "description": "string",
        "photo": [
          {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          }
        ],
        "text": "string",
        "text_entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "animation": {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "duration": 42,
          "thumb": {
            "file_id": "string",
            "file_unique_id": "string",
            "width": 42,
            "height": 42,
            "file_size": 42
          },
          "file_name": "string",
          "mime_type": "string",
          "file_size": 42
        }
      },
      "poll": {
        "id": "string",
        "question": "string",
        "options": [
          {
            "text": "string",
            "voter_count": 42
          }
        ],
        "total_voter_count": 42,
        "is_closed": true,
        "is_anonymous": true,
        "type": "string",
        "allows_multiple_answers": true,
        "correct_option_id": 42,
        "explanation": "string",
        "explanation_entities": [
          {
            "type": "mention",
            "offset": 42,
            "length": 42,
            "url": "string",
            "user": {
              "id": 42,
              "is_bot": true,
              "first_name": "string",
              "last_name": "string",
              "username": "string",
              "language_code": "string",
              "can_join_groups": true,
              "can_read_all_group_messages": true,
              "supports_inline_queries": true
            },
            "language": "string"
          }
        ],
        "open_period": 42,
        "close_date": 42
      },
      "venue": {
        "location": {
          "longitude": 42.0,
          "latitude": 42.0,
          "horizontal_accuracy": 42.0,
          "live_period": 42,
          "heading": 42,
          "proximity_alert_radius": 42
        },
        "foursquare_id": "string",
        "title": "string",
        "address": "string",
        "foursquare_type": "string",
        "google_place_id": "string",
        "google_place_type": "string"
      },
      "location": {
        "longitude": 42.0,
        "latitude": 42.0,
        "horizontal_accuracy": 42.0,
        "live_period": 42,
        "heading": 42,
        "proximity_alert_radius": 42
      },
      "new_chat_members": [
        {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        }
      ],
      "left_chat_member": {
        "id": 42,
        "is_bot": true,
        "first_name": "string",
        "last_name": "string",
        "username": "string",
        "language_code": "string",
        "can_join_groups": true,
        "can_read_all_group_messages": true,
        "supports_inline_queries": true
      },
      "new_chat_title": "string",
      "new_chat_photo": [
        {
          "file_id": "string",
          "file_unique_id": "string",
          "width": 42,
          "height": 42,
          "file_size": 42
        }
      ],
      "delete_chat_photo": true,
      "group_chat_created": true,
      "supergroup_chat_created": true,
      "channel_chat_created": true,
      "migrate_to_chat_id": 42,
      "migrate_from_chat_id": 42,
      "pinned_message": {},
      "invoice": {
        "title": "string",
        "description": "string",
        "start_parameter": "string",
        "currency": "string",
        "total_amount": 42
      },
      "successful_payment": {
        "currency": "string",
        "total_amount": 42,
        "invoice_payload": "string",
        "shipping_option_id": "string",
        "order_info": {
          "name": "string",
          "phone_number": "string",
          "email": "string",
          "shipping_address": {
            "country_code": "string",
            "state": "string",
            "city": "string",
            "street_line1": "string",
            "street_line2": "string",
            "post_code": "string"
          }
        },
        "telegram_payment_charge_id": "string",
        "provider_payment_charge_id": "string"
      },
      "connected_website": "string",
      "passport_data": {
        "data": [
          {
            "type": "personal_details",
            "data": "string",
            "phone_number": "string",
            "email": "string",
            "files": [
              {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              }
            ],
            "front_side": {
              "file_id": "string",
              "file_unique_id": "string",
              "file_size": 42,
              "file_date": 42
            },
            "reverse_side": {
              "file_id": "string",
              "file_unique_id": "string",
              "file_size": 42,
              "file_date": 42
            },
            "selfie": {
              "file_id": "string",
              "file_unique_id": "string",
              "file_size": 42,
              "file_date": 42
            },
            "translation": [
              {
                "file_id": "string",
                "file_unique_id": "string",
                "file_size": 42,
                "file_date": 42
              }
            ],
            "hash": "string"
          }
        ],
        "credentials": {
          "data": "string",
          "hash": "string",
          "secret": "string"
        }
      },
      "proximity_alert_triggered": {
        "traveler": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "watcher": {
          "id": 42,
          "is_bot": true,
          "first_name": "string",
          "last_name": "string",
          "username": "string",
          "language_code": "string",
          "can_join_groups": true,
          "can_read_all_group_messages": true,
          "supports_inline_queries": true
        },
        "distance": 42
      },
      "reply_markup": {
        "": [
          [
            {}
          ]
        ]
      }
    }
  ]
}

Use this method to send a group of photos

Body Required

chat_id integer | string Required

media array[object] Required

Responses