---
title: "Get updates"
method: GET
path: "/updates"
tags: ["subscriptions"]
---

# Get updates

`GET /updates`

## Request

- Base URL: `https://botapi.tamtam.chat`
- URL: `https://botapi.tamtam.chat/updates`
- Auth: API key in query parameter `access_token`

You can use this method for getting updates in case your bot is not subscribed to WebHook. The method is based on long polling.

Every update has its own sequence number. `marker` property in response points to the next upcoming update.

All previous updates are considered as *committed* after passing `marker` parameter.
If `marker` parameter is **not passed**, your bot will get all updates happened after the last commitment.

## Query parameters

- `limit` integer
- `timeout` integer
- `marker` integer, nullable
- `types` string[], nullable

## Response `200`

List of updates

- UpdateList: List of all updates in chats your bot participated in
  - `updates` Update[], required: Page of updates
    - `update_type` string, required
    - `timestamp` integer, required: Unix-time when event has occurred
  - `marker` integer, nullable, required: Pointer to the next data page

## Other responses

- `401`: Authorization Error. No `access_token` provided or token is invalid
- `405`: Method is not allowed
- `500`: Internal Server Error

## Changes

- **2019-11-12** `98083e9105a3`: 1 info
  - added `message_construction_request, message_constructed` discriminator mapping keys to the `updates/items/` response property for the response status `200`
- **2019-10-31** `d13dc0b9632b`: 1 info
  - added `message_chat_created` discriminator mapping keys to the `updates/items/` response property for the response status `200`

[Operation history](https://skmtc.dev/tamtam/apis/tamtam-bot-api/changes/updates/get.md)

---

[API](https://skmtc.dev/tamtam/apis/tamtam-bot-api.md) - [All operations](https://skmtc.dev/tamtam/apis/tamtam-bot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tamtam/apis/tamtam-bot-api/revisions/fa85402ea716?raw)