Get

[POST] .../v1/event/get

Returns saved events for restoring lost realtime/webhook notifications. Use this method when an integration needs to restore persisted realtime or webhook events after a delivery gap. The request must contain exactly one anchor: last_event_id to continue after a known event or occurred_at to start from a UTC Unix time inside the configured retention window; anchors can be supplied either as filters. The public filters metadata exposes connected_integration_id, last_event_id, occurred_at and action as real request filters; from_date remains a alias for occurred_at. Optional connected_integration_id narrows events to one connected integration, action narrows event types, the actions alias and limit is capped by server settings. Access is scoped to the current API account and current request user context; the controller does not perform a separate user permission check. The method reads event history for the current API account, requires the webhook tariff option and a ready event-history database version and returns events with next_event_id and has_more for paging. Missing body, missing or conflicting anchors, invalid last_event_id, expired occurred_at/from_date, unavailable tariff option, missing connected integration, unsupported actions, storage readiness issues and database failures are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
filters Array of Filter Optional Optional filters by fields available for this API method.
limit Int32 Optional Maximum number of events in the response.

Filterable Fields

Field Type Description
action string
actions string Filter by event types.
connected_integration_id string Connected integration whose events must be restored.
from_date int UTC Unix time from which events must be returned. Use the occurred_at filter field in new requests.
last_event_id string Last received event_id. Events after this value are returned.
occurred_at int

Request Example

{
  "filters": [
    {
      "field": "connected_integration_id",
      "operator": "Equal",
      "value": "ci_01HZX2T7ZQF4H2"
    },
    {
      "field": "occurred_at",
      "operator": "GreaterOrEqual",
      "value": "1767225600"
    },
    {
      "field": "action",
      "operator": "In",
      "value": "ItemAdded,ItemEdited"
    }
  ],
  "limit": 100
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result EventGetResult Result object.

Response Example

{
  "ok": true,
  "result": {
    "events": [
      {
        "event_id": "2f5c8d71-4a4c-0c90-8c1f-28ff7f4a7f1b",
        "occurred_at": "2026-07-20T07:30:00Z",
        "action": "ItemAdded",
        "data": {
          "id": 1001
        }
      }
    ],
    "next_event_id": "2f5c8d71-4a4c-0c90-8c1f-28ff7f4a7f1b",
    "has_more": false
  }
}