Skip to main content
ZStack
Alerting & Response/On-Call

GetEscalationStatus

Get the current escalation status and level for a given alert

GET/api/v1/oncall/alerts/{alertId}/escalation-status

Operation ID

GetEscalationStatus

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

  • alertId
    StringRequired

    Identifier of the alert whose escalation status to retrieve

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • uuid
    String

    Unique identifier for this escalation state instance

    Example: esc-aabbccdd

  • alertId
    String

    Identifier of the alert being escalated

    Example: alert-99887766

  • policyId
    String

    ID of the escalation policy governing this escalation

    Example: pol-11223344

  • currentLevel
    Integer

    Current escalation level reached for this alert

    Example: 2

  • status
    String

    Current status of the escalation (e.g. active, acknowledged, resolved)

    Example: active

  • startTime
    String

    Timestamp when escalation processing started

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

  • lastNotify
    String

    Timestamp of the most recent notification sent

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