---
title: "Получение списка подписок · бесплатно"
method: GET
path: "/v1/callback/subscriptions"
tags: ["Уведомления"]
---

# Получение списка подписок · бесплатно

`GET /v1/callback/subscriptions`

## Request

- Base URL: `https://maxstat.ru/api`
- URL: `https://maxstat.ru/api/v1/callback/subscriptions`
- Auth: API key in header `X-API-Token`

> 💳 **Стоимость:** бесплатно

Возвращает список webhook-подписок, созданных с вашим API-токеном. Подписки можно отфильтровать по признаку активности и типу.

## Query parameters

- `active` boolean, nullable: Фильтр по статусу подписки. Если параметр не передан, возвращаются все подписки.
- `subscription_type` 'channel' | 'keyword', nullable: Фильтр по типу подписки: `channel` или `keyword`. Если не передан, возвращаются все подписки.

## Response `200`

Successful Response

- SubscriptionsResponse
  - `items` SubscriptionResponse[]: Список webhook-подписок, созданных с вашим API-токеном.
    - `id` string, uuid, required: Идентификатор подписки.
    - `type` 'channel' | 'keyword', required: Тип подписки: `channel` для канала или `keyword` для поискового запроса.
    - `active` boolean: Признак активности подписки. Неактивные подписки не обрабатываются.
    - `callback_url` string, required: URL, на который отправляются уведомления по подписке.
    - `channel_id` string, nullable: Идентификатор отслеживаемого канала. Заполняется только для подписок типа `channel`.
    - `query` string, nullable: Поисковый запрос. Заполняется только для подписок типа `keyword`.
    - `category_id` integer, nullable: Идентификатор категории канала для подписки типа `keyword`, если фильтр задан.
    - `last_processed_at` string, date-time, nullable: Дата и время, до которых MaxStat проверил новые публикации по этой подписке.
    - `last_matched_at` string, date-time, nullable: Дата и время последней отправки уведомления с найденными публикациями.
    - `last_error_at` string, date-time, nullable: Дата и время последней ошибки при отправке уведомления.
    - `last_error_type` string, nullable: Имя класса исключения последней ошибки доставки, например `ConnectError` или `HTTPStatusError`.
    - `consecutive_failures` integer: Количество последовательных ошибок доставки. При достижении порога подписка автоматически деактивируется.
    - `created_at` string, date-time, required: Дата и время создания подписки.
    - `updated_at` string, date-time, required: Дата и время последнего обновления подписки.

## Other responses

- `401`: Ошибка аутентификации: API-токен не передан, недействителен или отозван.
- `402`: Проблема с тарифом: нет активного периода подписки или недостаточно кредитов.
- `403`: Доступ запрещён.
- `422`: Ошибка валидации параметров запроса. Подробности — в поле details.
- `429`: Превышен лимит запросов. Повторите запрос позже.
- `500`: Внутренняя ошибка сервиса. Сообщите request_id в поддержку.
- `503`: Сервис временно перегружен. Повторите запрос через несколько секунд (см. заголовок Retry-After).

---

[API](https://skmtc.dev/maxstat/apis/maxstat-public-api.md) · [All operations](https://skmtc.dev/maxstat/apis/maxstat-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maxstat/apis/maxstat-public-api/revisions/4eff97f9a0b2?raw)