telegram-bot-api-versions/README.md

# Telegram Bot API versions

This repository aims to store a schema for every version of the Telegram Bot API.

The goal is achieved by using [TGScraper](https://github.com/Sysbot-org/tgscraper). Old bot API schemas have been
extracted by using [The Wayback Machine](https://web.archive.org/web/*/https://core.telegram.org/bots/api).


## Versions list

| Version           | Description                                                                                               | Release date                                                                         | Schema                                                                                               |
|-------------------|-----------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------|
| 1.0               | First release.                                                                                            | [June 24, 2015](https://core.telegram.org/bots/api-changelog#june-24-2015)           | [JSON](files/json/v100.json), [Postman](files/postman/v100.json), [YAML](files/yaml/v100.yaml)       |
| 1.1               | Minor changes.                                                                                            | [July 2015](https://core.telegram.org/bots/api-changelog#july-2015)                  | [JSON](files/json/v110.json), [Postman](files/postman/v110.json), [YAML](files/yaml/v110.yaml)       |
| 1.2               | Voice messages.                                                                                           | [August 15, 2015](https://core.telegram.org/bots/api-changelog#august-15-2015)       | Not available.                                                                                       |
| 1.3               | Support for self-signed certificates and webhook payload requests.                                        | [August 29, 2015](https://core.telegram.org/bots/api-changelog#august-29-2015)       | Not available.                                                                                       |
| 1.4               | JSON requests, basic Markdown support.                                                                    | [September 7, 2015](https://core.telegram.org/bots/api-changelog#september-7-2015)   | [JSON](files/json/v140.json), [Postman](files/postman/v140.json), [YAML](files/yaml/v140.yaml)       |
| 1.5               | Download files and media sent by users.                                                                   | [September 18, 2015](https://core.telegram.org/bots/api-changelog#september-18-2015) | [JSON](files/json/v150.json), [Postman](files/postman/v150.json), [YAML](files/yaml/v150.yaml)       |
| 1.6               | Introduced channel support for bots.                                                                      | [October 8, 2015](https://core.telegram.org/bots/api-changelog#october-8-2015)       | [JSON](files/json/v160.json), [Postman](files/postman/v160.json), [YAML](files/yaml/v160.yaml)       |
| 1.7               | Introduced supergroup support for bots.                                                                   | [November 2015](https://core.telegram.org/bots/api-changelog#november-2015)          | Not available.                                                                                       |
| 1.8               | Inline mode support.                                                                                      | [January 4, 2016](https://core.telegram.org/bots/api-changelog#january-4-2016)       | [JSON](files/json/v180.json), [Postman](files/postman/v180.json), [YAML](files/yaml/v180.yaml)       |
| 1.8.1             | Added ChosenInlineResult.                                                                                 | [January 14, 2016](https://core.telegram.org/bots/api-changelog#january-14-2016)     | Not available.                                                                                       |
| 1.8.2             | Added support for HTML-style formatting.                                                                  | [January 20, 2016](https://core.telegram.org/bots/api-changelog#january-20-2016)     | [JSON](files/json/v182.json), [Postman](files/postman/v182.json), [YAML](files/yaml/v182.yaml)       |
| 1.8.3             | Support for sending silent messages.                                                                      | [February 20, 2016](https://core.telegram.org/bots/api-changelog#february-20-2016)   | [JSON](files/json/v183.json), [Postman](files/postman/v183.json), [YAML](files/yaml/v183.yaml)       |
| 2.0               | Message editing, inline keyboards introduced, improved inline mode, basic administration tools.           | [April 9, 2016](https://core.telegram.org/bots/api-changelog#april-9-2016)           | [JSON](files/json/v200.json), [Postman](files/postman/v200.json), [YAML](files/yaml/v200.yaml)       |
| 2.0.1             | Minor changes.                                                                                            | [May 6, 2016](https://core.telegram.org/bots/api-changelog#may-6-2016)               | Not available.                                                                                       |
| 2.0.2             | Message consistency for bot in groups and supergroups.                                                    | [May 12, 2016](https://core.telegram.org/bots/api-changelog#may-12-2016)             | Not available.                                                                                       |
| 2.1               | More administration tools, support for edited messages and mentions.                                      | [May 22, 2016](https://core.telegram.org/bots/api-changelog#may-22-2016)             | [JSON](files/json/v210.json), [Postman](files/postman/v210.json), [YAML](files/yaml/v210.yaml)       |
| 2.1.1             | Added support for inline keyboards in groups.                                                             | [May 25, 2016](https://core.telegram.org/bots/api-changelog#may-25-2016)             | [JSON](files/json/v211.json)\*, [Postman](files/postman/v211.json)\*, [YAML](files/yaml/v211.yaml)*  |
| 2.2               | Gaming Platform, various changes.                                                                         | [October 3, 2016](https://core.telegram.org/bots/api-changelog#october-3-2016)       | [JSON](files/json/v220.json), [Postman](files/postman/v220.json), [YAML](files/yaml/v220.yaml)       |
| 2.3               | Channel post updates, callback query cache, other changes.                                                | [November 21, 2016](https://core.telegram.org/bots/api-changelog#november-21-2016)   | [JSON](files/json/v230.json), [Postman](files/postman/v230.json), [YAML](files/yaml/v230.yaml)       |
| 2.3.1             | Webhook improvements.                                                                                     | [December 4, 2016](https://core.telegram.org/bots/api-changelog#december-4-2016)     | [JSON](files/json/v231.json), [Postman](files/postman/v231.json), [YAML](files/yaml/v231.yaml)       |
| 3.0               | Payment Platform, video messages, language code.                                                          | [May 18, 2017](https://core.telegram.org/bots/api-changelog#may-18-2017)             | [JSON](files/json/v300.json), [Postman](files/postman/v300.json), [YAML](files/yaml/v300.yaml)       |
| 3.1               | ChatMember permissions, temporary bans, support for pinning and unpinning messages.                       | [June 30, 2017](https://core.telegram.org/bots/api-changelog#june-30-2017)           | [JSON](files/json/v310.json), [Postman](files/postman/v310.json), [YAML](files/yaml/v310.yaml)       |
| 3.2               | Support for sticker sets management.                                                                      | [July 21, 2017](https://core.telegram.org/bots/api-changelog#july-21-2017)           | [JSON](files/json/v320.json), [Postman](files/postman/v320.json), [YAML](files/yaml/v320.yaml)       |
| 3.3               | Support for creating mentions, other minor changes.                                                       | [August 23, 2017](https://core.telegram.org/bots/api-changelog#august-23-2017)       | [JSON](files/json/v330.json), [Postman](files/postman/v330.json), [YAML](files/yaml/v330.yaml)       |
| 3.4               | Support for Live Location and group sticker sets management.                                              | [October 11, 2017](https://core.telegram.org/bots/api-changelog#october-11-2017)     | Not available.                                                                                       |
| 3.5               | Media albums, message pinning in channel.                                                                 | [November 17, 2017](https://core.telegram.org/bots/api-changelog#november-17-2017)   | [JSON](files/json/v350.json), [Postman](files/postman/v350.json), [YAML](files/yaml/v350.yaml)       |
| 3.6               | Text formatting in captions, Login Widget support.                                                        | [February 13, 2018](https://core.telegram.org/bots/api-changelog#february-13-2018)   | [JSON](files/json/v360.json), [Postman](files/postman/v360.json), [YAML](files/yaml/v360.yaml)       |
| 4.0               | Telegram Passport, edit media content in messages, other major changes.                                   | [July 26, 2018](https://core.telegram.org/bots/api-changelog#july-26-2018)           | [JSON](files/json/v400.json), [Postman](files/postman/v400.json), [YAML](files/yaml/v400.yaml)       |
| 4.1               | Minor changes for Telegram Passport.                                                                      | [August 27, 2018](https://core.telegram.org/bots/api-changelog#august-27-2018)       | [JSON](files/json/v410.json), [Postman](files/postman/v410.json), [YAML](files/yaml/v410.yaml)       |
| 4.2               | Added Poll support, pin messages in basic groups, other major changes.                                    | [April 14, 2019](https://core.telegram.org/bots/api-changelog#april-14-2019)         | [JSON](files/json/v420.json), [Postman](files/postman/v420.json), [YAML](files/yaml/v420.yaml)       |
| 4.3               | Seamless Telegram Login, ReplyMarkup included in Message object.                                          | [May 31, 2019](https://core.telegram.org/bots/api-changelog#may-31-2019)             | [JSON](files/json/v430.json), [Postman](files/postman/v430.json), [YAML](files/yaml/v430.yaml)       |
| 4.4               | Support for animated stickers and default chat permissions.                                               | [July 29, 2019](https://core.telegram.org/bots/api-changelog#july-29-2019)           | [JSON](files/json/v440.json), [Postman](files/postman/v440.json), [YAML](files/yaml/v440.yaml)       |
| 4.5               | MarkdownV2 support, nested Message entities, file unique ID, custom administrator title.                  | [December 31, 2019](https://core.telegram.org/bots/api-changelog#december-31-2019)   | [JSON](files/json/v450.json), [Postman](files/postman/v450.json), [YAML](files/yaml/v450.yaml)       |
| 4.6               | Polls 2.0, improved getMe.                                                                                | [January 23, 2020](https://core.telegram.org/bots/api-changelog#january-23-2020)     | [JSON](files/json/v460.json), [Postman](files/postman/v460.json), [YAML](files/yaml/v460.yaml)       |
| 4.7               | Dice support, setMyCommands and getMyCommands, support for creating animated sticker packs.               | [March 30, 2020](https://core.telegram.org/bots/api-changelog#march-30-2020)         | [JSON](files/json/v470.json), [Postman](files/postman/v470.json), [YAML](files/yaml/v470.yaml)       |
| 4.8               | Dart support for dice, explanations for quizzes, automatically close poll.                                | [April 24, 2020](https://core.telegram.org/bots/api-changelog#april-24-2020)         | [JSON](files/json/v480.json), [Postman](files/postman/v480.json), [YAML](files/yaml/v480.yaml)       |
| 4.9               | via_bot field in Message object, basketball support for dice.                                             | [June 4, 2020](https://core.telegram.org/bots/api-changelog#june-4-2020)             | [JSON](files/json/v490.json), [Postman](files/postman/v490.json), [YAML](files/yaml/v490.yaml)       |
| 5.0               | Self-host Bot API, transfer bot ownership, other major changes.                                           | [November 4, 2020](https://core.telegram.org/bots/api-changelog#november-4-2020)     | [JSON](files/json/v500.json), [Postman](files/postman/v500.json), [YAML](files/yaml/v500.yaml)       |
| 5.1               | New Update type: ChatMemberUpdated. Improved chat invite links, voice chats support, other major changes. | [March 9, 2021](https://core.telegram.org/bots/api-changelog#march-9-2021)           | [JSON](files/json/v510.json), [Postman](files/postman/v510.json), [YAML](files/yaml/v510.yaml)       |
| 5.2               | Payments 2.0, other minor changes.                                                                        | [April 26, 2021](https://core.telegram.org/bots/api-changelog#april-26-2021)         | [JSON](files/json/v520.json), [Postman](files/postman/v520.json), [YAML](files/yaml/v520.yaml)       |
| 5.3 **(current)** | Scoped commands, ChatMember splitting                                                                     | [June 25, 2021](https://core.telegram.org/bots/api-changelog#june-25-2021)           | [JSON](files/json/v530.json), [Postman](files/postman/v530.json), [YAML](files/yaml/v530.yaml)       |

*Unchanged from previous version.

## Found a missing version?

Please, open an issue [here](https://github.com/sys-001/telegram-bot-api-versions/issues) providing the link and specifying the target version. It would help a lot!