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

# Get subscriptions

`GET /subscriptions`

## Request

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

In case your bot gets data via WebHook, the method returns list of all subscriptions

## Response `200`

As expected

- GetSubscriptionsResult: List of all WebHook subscriptions
  - `subscriptions` Subscription[], required: Current subscriptions
    - `url` string, required: Webhook URL
    - `time` integer, required: Unix-time when subscription was created
    - `update_types` string[], nullable, required: Update types bot subscribed for
    - `version` string, nullable, required

## Other responses

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

---

[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)