Archive repository where you can find schemas for all versions of the Telegram bot API.
Go to file
2021-12-31 14:07:05 +01:00
files Bot API 5.5 and 5.6 2021-12-31 14:07:05 +01:00
_config.yml Set theme jekyll-theme-cayman 2021-06-16 17:35:02 +02:00
.gitignore Added YAML and Postman formats, updated old JSON schemas 2021-07-24 23:05:28 +02:00
CNAME Create CNAME 2021-11-08 11:13:33 +00:00
composer.json Added OpenAPI and stubs, updated to bot API 5.4 2021-11-08 19:09:46 +01:00
composer.lock Bot API 5.5 and 5.6 2021-12-31 14:07:05 +01:00
extract.php Added OpenAPI and stubs, updated to bot API 5.4 2021-11-08 19:09:46 +01:00
README.md Added OpenAPI and stubs, updated to bot API 5.4 2021-11-08 19:09:46 +01:00

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. Old bot API schemas have been extracted by using The Wayback Machine.

Versions list

Version Description Release date Custom Postman OpenAPI Stubs
1.0 First release. June 24, 2015 JSON, YAML JSON JSON, YAML ZIP
1.1 Minor changes. July 2015 JSON, YAML JSON JSON, YAML ZIP
1.2 Voice messages. August 15, 2015 Not available. Not available. Not available. Not available.
1.3 Support for self-signed certificates and webhook payload requests. August 29, 2015 Not available. Not available. Not available. Not available.
1.4 JSON requests, basic Markdown support. September 7, 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.6 Introduced channel support for bots. October 8, 2015 JSON, YAML JSON JSON, YAML ZIP
1.7 Introduced supergroup support for bots. November 2015 Not available. Not available. Not available. Not available.
1.8 Inline mode support. January 4, 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.2 Added support for HTML-style formatting. January 20, 2016 JSON, YAML JSON JSON, YAML ZIP
1.8.3 Support for sending silent messages. February 20, 2016 JSON, YAML JSON JSON, YAML ZIP
2.0 Message editing, inline keyboards introduced, improved inline mode, basic administration tools. April 9, 2016 JSON, YAML JSON JSON, YAML ZIP
2.0.1 Minor changes. May 6, 2016 Not available. Not available. Not available. Not available.
2.0.2 Message consistency for bot in groups and supergroups. May 12, 2016 Not available. Not available. Not available. Not available.
2.1 More administration tools, support for edited messages and mentions. May 22, 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.2 Gaming Platform, various changes. October 3, 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.3.1 Webhook improvements. December 4, 2016 JSON, YAML JSON JSON, YAML ZIP
3.0 Payment Platform, video messages, language code. May 18, 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.2 Support for sticker sets management. July 21, 2017 JSON, YAML JSON JSON, YAML ZIP
3.3 Support for creating mentions, other minor changes. August 23, 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.5 Media albums, message pinning in channel. November 17, 2017 JSON, YAML JSON JSON, YAML ZIP
3.6 Text formatting in captions, Login Widget support. February 13, 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
4.1 Minor changes for Telegram Passport. August 27, 2018 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.3 Seamless Telegram Login, ReplyMarkup included in Message object. May 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.5 MarkdownV2 support, nested Message entities, file unique ID, custom administrator title. December 31, 2019 JSON, YAML JSON JSON, YAML ZIP
4.6 Polls 2.0, improved getMe. January 23, 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.8 Dart support for dice, explanations for quizzes, automatically close poll. April 24, 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
5.0 Self-host Bot API, transfer bot ownership, other major changes. November 4, 2020 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.2 Payments 2.0, other minor changes. April 26, 2021 JSON, YAML JSON JSON, YAML ZIP
5.3 Scoped commands, ChatMember splitting. June 25, 2021 JSON, YAML JSON JSON, YAML ZIP
5.4 (current) Chat join requests, choose_sticker chat action. November 5, 2021 JSON, YAML JSON JSON, YAML ZIP

*Unchanged from previous version.

Found a missing version?

Please, open an issue here providing the link and specifying the target version. It would help a lot!