This repository aims to store a schema for every version of the Telegram Bot API.
The goal is achieved by using TGScraper. Old bot API schemas have been extracted by using The Wayback Machine.
| Version | Description | Release date | Custom | Postman | OpenAPI | Stubs |
|---|---|---|---|---|---|---|
| 7.0 (current) | Reactions, new replies and link previews, batch actions, boosts and giveaways. | December 29, 2023 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 6.9 | Unlimited cloud storage for Mini Apps, support for stories permissions. | September 22, 2023 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 6.8 | Stories detection, anonymous poll votes, emoji status expiration date. | August 18, 2023 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 6.7 | Web Apps in any chat, collectible usernames, send custom emoji, localized names, shared folder invites. | April 21, 2023 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 6.6 | Localized descriptions, custom emoji sets, improved editing for sticker sets. | March 9, 2023 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 6.5 | Chat and User selection, improved permissions. | February 3, 2023 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 6.4 | Topics improvements, media spoilers, persistent reply markup. | December 30, 2022 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 6.3 | Topics, multiple usernames. | November 5, 2022 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 6.2 | Animated emojis, privacy for audio and video messages. | August 12, 2022 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 6.1 | Telegram Premium, public join requests, attachment menu. | June 20, 2022 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 6.0 | Web Apps, default administrator rights. | April 16, 2022 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 5.7 | Video stickers. | January 31, 2022 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 5.6 | Spoilers, send messages as protected content. | December 30, 2021 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 5.5 | Start chats by join requests, protected content, anonymous channels. | December 7, 2021 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 5.4 | Chat join requests, choose_sticker chat action. | November 5, 2021 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 5.3 | Scoped commands, ChatMember splitting. | June 25, 2021 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 5.2 | Payments 2.0, other minor changes. | April 26, 2021 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 5.1 | New Update type: ChatMemberUpdated. Improved chat invite links, voice chats support, other major changes. | March 9, 2021 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 5.0 | Self-host Bot API, transfer bot ownership, other major changes. | November 4, 2020 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 4.9 | via_bot field in Message object, basketball support for dice. | June 4, 2020 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 4.8 | Dart support for dice, explanations for quizzes, automatically close poll. | April 24, 2020 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 4.7 | Dice support, setMyCommands and getMyCommands, support for creating animated sticker packs. | March 30, 2020 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 4.6 | Polls 2.0, improved getMe. | January 23, 2020 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 4.5 | MarkdownV2 support, nested Message entities, file unique ID, custom administrator title. | December 31, 2019 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 4.4 | Support for animated stickers and default chat permissions. | July 29, 2019 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 4.3 | Seamless Telegram Login, ReplyMarkup included in Message object. | May 31, 2019 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 4.2 | Added Poll support, pin messages in basic groups, other major changes. | April 14, 2019 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 4.1 | Minor changes for Telegram Passport. | August 27, 2018 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 4.0 | Telegram Passport, edit media content in messages, other major changes. | July 26, 2018 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 3.6 | Text formatting in captions, Login Widget support. | February 13, 2018 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 3.5 | Media albums, message pinning in channel. | November 17, 2017 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 3.4 | Support for Live Location and group sticker sets management. | October 11, 2017 | Not available. | Not available. | Not available. | Not available. |
| 3.3 | Support for creating mentions, other minor changes. | August 23, 2017 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 3.2 | Support for sticker sets management. | July 21, 2017 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 3.1 | ChatMember permissions, temporary bans, support for pinning and unpinning messages. | June 30, 2017 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 3.0 | Payment Platform, video messages, language code. | May 18, 2017 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 2.3.1 | Webhook improvements. | December 4, 2016 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 2.3 | Channel post updates, callback query cache, other changes. | November 21, 2016 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 2.2 | Gaming Platform, various changes. | October 3, 2016 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 2.1.1 | Added support for inline keyboards in groups. | May 25, 2016 | JSON*, YAML* | JSON* | JSON*, YAML* | ZIP* |
| 2.1 | More administration tools, support for edited messages and mentions. | May 22, 2016 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 2.0.2 | Message consistency for bot in groups and supergroups. | May 12, 2016 | Not available. | Not available. | Not available. | Not available. |
| 2.0.1 | Minor changes. | May 6, 2016 | Not available. | Not available. | Not available. | Not available. |
| 2.0 | Message editing, inline keyboards introduced, improved inline mode, basic administration tools. | April 9, 2016 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 1.8.3 | Support for sending silent messages. | February 20, 2016 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 1.8.2 | Added support for HTML-style formatting. | January 20, 2016 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 1.8.1 | Added ChosenInlineResult. | January 14, 2016 | Not available. | Not available. | Not available. | Not available. |
| 1.8 | Inline mode support. | January 4, 2016 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 1.7 | Introduced supergroup support for bots. | November 2015 | Not available. | Not available. | Not available. | Not available. |
| 1.6 | Introduced channel support for bots. | October 8, 2015 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 1.5 | Download files and media sent by users. | September 18, 2015 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 1.4 | JSON requests, basic Markdown support. | September 7, 2015 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 1.3 | Support for self-signed certificates and webhook payload requests. | August 29, 2015 | Not available. | Not available. | Not available. | Not available. |
| 1.2 | Voice messages. | August 15, 2015 | Not available. | Not available. | Not available. | Not available. |
| 1.1 | Minor changes. | July 2015 | JSON, YAML | JSON | JSON, YAML | ZIP |
| 1.0 | First release. | June 24, 2015 | JSON, YAML | JSON | JSON, YAML | ZIP |
*Unchanged from previous version.
Please, open an issue here providing the link and specifying the target version. It would help a lot!