Skip to main content
ZStack
Alerting & Response/Alert Rules

ListAlertEscalationEvents

List escalation events triggered by a specific alert rule

GET/api/v1/alerting/rules/{ruleId}/logging-escalation/events

Operation ID

ListAlertEscalationEvents

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

Path Parameters

  • ruleId
    StringRequired

    Alert rule identifier to list events for

Query Parameters

  • limit
    Integer

    Maximum number of recent events to return Maximum number of recent events to return

    Example: 0

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • items
    List

    List of escalation events

    Example: (nested array)

    • eventId
      String

      Unique identifier of the escalation event

      Example: esc-event-001

    • ruleId
      String

      Alert rule identifier that triggered this event

      Example: rule-abc123

    • alertId
      String

      Alert identifier associated with this escalation

      Example: alert-789xyz

    • triggeredAt
      String

      Timestamp when the escalation was triggered

      Example: 2026-01-15T08:00:00Z

    • matchedKeyword
      String

      Keyword pattern that triggered the escalation

      Example: OutOfMemory

    • matchCount
      Integer

      Number of keyword matches within the window

      Example: 5

    • assignedToUserId
      String

      User assigned via on-call schedule

      Example: user-001

    • logContextSnippet
      String

      Snippet of matching log context

      Example: java.lang.OutOfMemoryError: Java heap space

    • status
      String

      Current status of the escalation event

      Example: triggered

  • total
    Integer

    total equals len(items); this endpoint uses limit (most-recent-N), not pagination.

    Example: 10

  • limit
    Integer

    Maximum items returned

    Example: 50

  • offset
    Integer

    Offset from start of result set

    Example: 20