---
title: "Get updates"
method: GET
path: "/bot{token}/getUpdates"
tags: ["Bot"]
---

# Get updates

`GET /bot{token}/getUpdates`

Long-polls the authenticated Bot's bounded pending-update queue.

## Path parameters

- `token` string, required

## Query parameters

- `offset` string — A positive decimal Inline message identifier
- `limit` string — A signed decimal integer string within JavaScript's safe-integer range
- `timeout` string — A signed decimal integer string within JavaScript's safe-integer range
- `message_trigger` 'all' | 'mentions'
- `allowed_updates` union
  - string
  - BotUpdateKey[]

## Headers

- `authorization` string

## Response `200`

BotGetUpdatesSuccess

- BotGetUpdatesSuccess — unresolved $ref

## Other responses

- `400` — The request parameters are missing or invalid.
- `401` — The bot token is missing or invalid.
- `403` — The bot is not allowed to perform this action.
- `404` — The requested method or resource was not found.
- `500` — The server could not complete the request.

## Changes

> 6 revisions in range; 1 could not be searched.

- **2026-08-25** `d19edad47c57` — 2 breaking, 1 info
  - removed the enum value `deleted_messages` from the property `anyOf[subschema #2]/items/` of the `query` request parameter `allowed_updates`
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` to the `result/allOf[#/components/schemas/BotGetUpdatesResult]/items/` response property `oneOf` list for the response status `200`
  - removed `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5, subschema #6` from the `result/allOf[#/components/schemas/BotGetUpdatesResult]/items/` response property `oneOf` list for the response status `200`
- **2026-08-17** `b6346dfdb79c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/inline/apis/inline-bot-http-api-docs/changes/bot:token/getUpdates/get.md)

---

[API](https://skmtc.dev/inline/apis/inline-bot-http-api-docs.md) · [All operations](https://skmtc.dev/inline/apis/inline-bot-http-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/inline/inline-bot-http-api-docs/revisions/69017b8dc5fe/schema)