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).
**NOTE: some versions may be broken, I haven't tested nor checked everything.**
| 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.5 | Download files and media sent by users. | [September 18, 2015](https://core.telegram.org/bots/api-changelog#september-18-2015) | [v1.5.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v1.5.json) |
| 1.6 | Introduced channel support for bots. | [October 8, 2015](https://core.telegram.org/bots/api-changelog#october-8-2015) | [v1.6.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v1.6.json) |
| 1.7 | Introduced supergroup support for bots. | [November 2015](https://core.telegram.org/bots/api-changelog#november-2015) | Not available. |
| 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) | [v2.1.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v2.1.json) |
| 2.1.1 | Added support for inline keyboards in groups. | [May 25, 2016](https://core.telegram.org/bots/api-changelog#may-25-2016) | [v2.1.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v2.1.json)* |
| 3.0 | Payment Platform, video messages, language code. | [May 18, 2017](https://core.telegram.org/bots/api-changelog#may-18-2017) | [v3.0.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v3.0.json) |
| 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) | [v3.1.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v3.1.json) |
| 3.2 | Support for sticker sets management. | [July 21, 2017](https://core.telegram.org/bots/api-changelog#july-21-2017) | [v3.2.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v3.2.json) |
| 3.3 | Support for creating mentions, other minor changes. | [August 23, 2017](https://core.telegram.org/bots/api-changelog#august-23-2017) | [v3.3.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v3.3.json) |
| 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) | [v3.5.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v3.5.json) |
| 3.6 | Text formatting in captions, Login Widget support. | [February 13, 2018](https://core.telegram.org/bots/api-changelog#february-13-2018) | [v3.6.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v3.6.json) |
| 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) | [v4.0.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v4.0.json) |
| 4.1 | Minor changes for Telegram Passport. | [August 27, 2018](https://core.telegram.org/bots/api-changelog#august-27-2018) | [v4.1.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v4.1.json) |
| 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) | [v4.2.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v4.2.json) |
| 4.3 | Seamless Telegram Login, ReplyMarkup included in Message object. | [May 31, 2019](https://core.telegram.org/bots/api-changelog#may-31-2019) | [v4.3.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v4.3.json) |
| 4.4 | Support for animated stickers and default chat permissions. | [July 29, 2019](https://core.telegram.org/bots/api-changelog#july-29-2019) | [v4.4.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v4.4.json) |
| 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) | [v4.7.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v4.7.json) |
| 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) | [v4.8.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v4.8.json) |
| 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) | [v4.9.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v4.9.json) |
| 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) | [v5.0.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v5.0.json) |
| 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) | [v5.1.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v5.1.json) |
| 5.2 **(current)** | Payments 2.0, other minor changes. | [April 26, 2021](https://core.telegram.org/bots/api-changelog#april-26-2021) | [v5.2.json](https://github.com/sys-001/telegram-bot-api-versions/blob/main/files/v5.2.json) |