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.

NOTE: some versions may be broken, I haven't tested nor checked everything.

Versions list

Version	Description	Release date	Schema
1.0	First release.	June 24, 2015	v1.0.json
1.1	Minor changes.	July 2015	v1.1.json
1.2	Voice messages.	August 15, 2015	Not available.
1.3	Support for self-signed certificates and webhook payload requests.	August 29, 2015	Not available.
1.4	JSON requests, basic Markdown support.	September 7, 2015	v1.4.json
1.5	Download files and media sent by users.	September 18, 2015	v1.5.json
1.6	Introduced channel support for bots.	October 8, 2015	v1.6.json
1.7	Introduced supergroup support for bots.	November 2015	Not available.
1.8	Inline mode support.	January 4, 2016	v1.8.json
1.8.1	Added ChosenInlineResult.	January 14, 2016	Not available.
1.8.2	Added support for HTML-style formatting.	January 20, 2016	v1.8.2.json
1.8.3	Support for sending silent messages.	February 20, 2016	v1.8.3.json
2.0	Message editing, inline keyboards introduced, improved inline mode, basic administration tools.	April 9, 2016	v2.0.json
2.0.1	Minor changes.	May 6, 2016	Not available.
2.0.2	Message consistency for bot in groups and supergroups.	May 12, 2016	Not available.
2.1	More administration tools, support for edited messages and mentions.	May 22, 2016	v2.1.json
2.1.1	Added support for inline keyboards in groups.	May 25, 2016	v2.1.json*
2.2	Gaming Platform, various changes.	October 3, 2016	v2.2.json
2.3	Channel post updates, callback query cache, other changes.	November 21, 2016	v2.3.json
2.3.1	Webhook improvements.	December 4, 2016	v2.3.1.json
3.0	Payment Platform, video messages, language code.	May 18, 2017	v3.0.json
3.1	ChatMember permissions, temporary bans, support for pinning and unpinning messages.	June 30, 2017	v3.1.json
3.2	Support for sticker sets management.	July 21, 2017	v3.2.json
3.3	Support for creating mentions, other minor changes.	August 23, 2017	v3.3.json
3.4	Support for Live Location and group sticker sets management.	October 11, 2017	Not available.
3.5	Media albums, message pinning in channel.	November 17, 2017	v3.5.json
3.6	Text formatting in captions, Login Widget support.	February 13, 2018	v3.6.json
4.0	Telegram Passport, edit media content in messages, other major changes.	July 26, 2018	v4.0.json
4.1	Minor changes for Telegram Passport.	August 27, 2018	v4.1.json
4.2	Added Poll support, pin messages in basic groups, other major changes.	April 14, 2019	v4.2.json
4.3	Seamless Telegram Login, ReplyMarkup included in Message object.	May 31, 2019	v4.3.json
4.4	Support for animated stickers and default chat permissions.	July 29, 2019	v4.4.json
4.5	MarkdownV2 support, nested Message entities, file unique ID, custom administrator title.	December 31, 2019	v4.5.json
4.6	Polls 2.0, improved getMe.	January 23, 2020	v4.6.json
4.7	Dice support, setMyCommands and getMyCommands, support for creating animated sticker packs.	March 30, 2020	v4.7.json
4.8	Dart support for dice, explanations for quizzes, automatically close poll.	April 24, 2020	v4.8.json
4.9	via_bot field in Message object, basketball support for dice.	June 4, 2020	v4.9.json
5.0	Self-host Bot API, transfer bot ownership, other major changes.	November 4, 2020	v5.0.json
5.1	New Update type: ChatMemberUpdated. Improved chat invite links, voice chats support, other major changes.	March 9, 2021	v5.1.json
5.2 (current)	Payments 2.0, other minor changes.	April 26, 2021	v5.2.json

*Unchanged from previous version.