Telegram Bot API

Hosts: api.telegram.org · 16 facts

Error meanings

• ✅ verified:server:prod · bad request: chat_id is empty · GET /{bot_token}/getChat · env prod
• ✅ verified:server:prod · bad request: chat not found · GET /{bot_token}/getChat · env prod
• 🔵 official · When a group has been migrated to a supergroup, the error's parameters.migrate_to_chat_id holds the supergroup's new identifier. · POST /{bot_token}/sendMessage · env prod
• ✅ verified:server:prod · bad request: invalid file_id · GET /{bot_token}/getFile · env prod
• ✅ verified:server:prod · not found · GET /{bot_token}/{method} · env prod
• ✅ verified:server:prod · bad request: user not found · GET /{bot_token}/{method} · env prod

Rate limits

• 🔵 official · Exceeding flood control returns HTTP 429; parameters.retry_after holds the number of seconds left to wait before the request can be repeated. · POST /{bot_token}/sendMessage · env prod
• 🔵 official · The documented sending limits are about one message per second per chat, 20 messages per minute per group and about 30 messages per second for broadcasts; past them the API answers 429. · POST /{bot_token}/sendMessage · env prod

Silent behavior

• ✅ verified:server:prod · Errors are a JSON object with ok: false, a description and an integer error_code equal to the HTTP status (documented as subject to change); there is no result field. · GET /{bot_token}/{method} · env prod
• 🔵 official · getUpdates does not work while an outgoing webhook is set up; the webhook has to be removed before updates can be polled. · GET /{bot_token}/getUpdates · env prod
• ✅ verified:server:prod · getUpdates with limit=0 or limit=1000, outside the documented 1-100, answers HTTP 200 instead of 400. · GET /{bot_token}/getUpdates · env prod
• ✅ verified:server:prod · Method names are case-insensitive: /getme and /GETME answer like /getMe. · GET /{bot_token}/getMe · env prod
• ✅ verified:server:prod · For a bot without a webhook, getWebhookInfo returns url as an empty string rather than omitting it, and getUpdates answers ok: true. · GET /{bot_token}/{method} · env prod
• 🔵 official · Incoming updates wait on the server until the bot receives them but are not kept longer than 24 hours; an update counts as confirmed once getUpdates is called with a higher offset. · GET /{bot_token}/getUpdates · env prod

Auth quirks

• ✅ verified:server:prod · unauthorized · GET /{bot_token}/getMe · env prod
• ✅ verified:server:prod · not found · GET /{bot_token}/getMe · env prod

Data: CC BY 4.0 · apifacts registry · This page is generated; edit the YAML, not the page.