Get

[POST] …/v1/event/get

Возвращает сохранённые события аккаунта для восстановления уведомлений, которые клиент мог потерять при разрыве соединения или временной недоступности получателя.

Метод работает с единой историей событий. Если connected_integration_id не указан, возвращается общий поток событий аккаунта. Если connected_integration_id указан, возвращаются только события, которые на момент публикации были предназначены этой подключённой интеграции.

Структура объекта события описана на странице Event.

Transient-события не сохраняются в истории и не возвращаются этим методом. К transient-событиям относятся события, актуальные только в момент доставки, например ChatWriting и ChatSuggest.

Входные параметры

Название	Тип данных	Обязательность	Ограничения	Описание
connected_integration_id	String	Необязательный	Должен соответствовать существующей подключённой интеграции	Фильтр по подключённой интеграции
last_event_id	String	Условно обязательный	UUID события из предыдущего ответа или полученного уведомления	Вернуть события после указанного `event_id`
from_date	Int64	Условно обязательный	Unix-время UTC; должно попадать в период хранения истории	Вернуть события с указанного времени
limit	Int32	Необязательный	Верхняя граница задаётся серверными настройками	Максимальное количество событий в ответе
actions	Array of String	Необязательный	Значения из списка событий	Фильтр по типам событий

Нужно указать ровно один якорь выборки: либо last_event_id, либо from_date.

Пример запроса от последнего события

{
  "last_event_id": "6b6b0a3a-9e5e-4d3a-9f6e-0c6e9f8b2a11",
  "limit": 100
}

Пример запроса для подключённой интеграции

{
  "connected_integration_id": "string",
  "from_date": 1782453600,
  "actions": [
    "DocOrderDeliveryAdded",
    "DocOrderDeliveryStatusSet"
  ],
  "limit": 100
}

Выходные параметры

Название	Тип данных	Описание
result.events	Array of Object	Массив событий
result.events.event_id	String	UUID события
result.events.occurred_at	DateTime	Дата и время возникновения события в UTC
result.events.action	String	Тип события
result.events.data	Object	Полезная нагрузка события
result.next_event_id	String	`event_id` последнего события в ответе; используйте как `last_event_id` для следующего запроса
result.has_more	Boolean	Признак наличия следующей страницы

Пример ответа

{
  "ok": true,
  "result": {
    "events": [
      {
        "event_id": "2f0f7b7a-7c43-4d91-917f-8f412ad0ab5e",
        "occurred_at": "2026-06-26T10:00:00Z",
        "action": "DocOrderDeliveryStatusSet",
        "data": {
          "id": 54321,
          "status": "Completed"
        }
      }
    ],
    "next_event_id": "2f0f7b7a-7c43-4d91-917f-8f412ad0ab5e",
    "has_more": false
  }
}

Ошибки

Метод возвращает ошибки в стандартном формате HTTP 200 + ErrorResult.

Код	Сценарий
1008	Не указан якорь выборки, указаны оба якоря, `last_event_id` не найден, событие уже удалено из истории или история событий ещё недоступна для базы аккаунта
1002	Неверный формат `last_event_id` или `from_date`
1044	`connected_integration_id` не найден

Хранение событий

Срок хранения истории событий - 7 дней с момента возникновения события. После окончания срока хранения событие удаляется из истории и больше не может быть восстановлено через Event/Get.

Если история событий ещё не поддерживается базой аккаунта, доставка событий продолжает работать без сохранения событий в истории, а Event/Get возвращает стандартную ошибку.