Using Telegram API

Recent articles

Secret chats, end-to-end encryption

New feature for end-to-end-encrypted messaging.

Security guidelines

Important checks required in your client application.

Getting started

Creating an application

How to get your applicaiton identifier and create a new Telegram app

User authorization

How to register a user's phone to start using the API.

Error handling

How to handle API return errors correctly.

Handling different data centers

How the nearest data center is selected for faster interaction with the API and things to beware of when developing a client.

Handling updates

How to sign for updates and handle incoming messages.

Handling PUSH-notifications

How to sign for and handle notifications.

Calling methods

Additional options for calling methods.

Uploading and Downloading Files

How to transfer large data batches correctly.


Client optimization

Ways to boost API interactions.

API methods

Available method list

Complete list of available high-level methods.

API TL-schema, as JSON

Text and JSON-presentation of types and methods used in API.

Available layer list

Complete list of available schema versions.

Source Code

Telegram Source Code can now be found on a separate page ยป


April 4, 2014 Added Layer 13 and Layer 14.
March 15, 2014 Added Layer 12.
December 21, 2013 Added Layer 11.
November 30, 2013 Added Layer 10.
October 30, 2013 Added Layer 9.
October 8, 2013 New article on secret chats. Added Layer 8.
September 6, 2013 17:00 New article on TL-schema layers, geochats, new requests. Added layers 2-4.
August 27, 2013 17:00 New article on client optimizations.
August 3, 2013 23:00 Updates for documents on polymorphism and vectors in TL. Now undersal vectors ae used in all cases, obsolete language on teemplates has been removed.
August 2, 2013 16:00 Added update constructor updateMessageID.
August 1, 2013 17:50 Description for joint updates, added constructor updatesCombined
July 31, 2013 18:00 Description for file upload/download logic
July 29, 2013 0:30 Description for gzip-compression use logic for clients
July 28, 2013 15:50 New article on testing mechanism for forwarding among data centers