Skip to main content
API Explorer|API Explorer
Alerting & Response/On-Call
GETOnCallSince 1.0SynchronousAuth Required

GetEscalationStatus

Get the current escalation status and level for a given alert

Execution Availability

Try It Out

Submit a mock request using the current auth context and example-driven inputs.

Path Parameters

Request Inputs

Path Parameters

  • alertIdStringRequired

    Identifier of the alert whose escalation status to retrieve

Responses

200 OK

On success, this API returns the following response structure.

  • uuidString

    Unique identifier for this escalation state instance

    Example: esc-aabbccdd

  • alertIdString

    Identifier of the alert being escalated

    Example: alert-99887766

  • policyIdString

    ID of the escalation policy governing this escalation

    Example: pol-11223344

  • currentLevelInteger

    Current escalation level reached for this alert

    Example: 2

  • statusString

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

    Example: active

  • startTimeString

    Timestamp when escalation processing started

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

  • lastNotifyString

    Timestamp of the most recent notification sent

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

Endpoint

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

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

Operation ID

GetEscalationStatus

Permalink

Request Example

curl -X GET '{host}/api/v1/oncall/alerts/{alertId}/escalation-status' -H 'Authorization: Bearer {token}'

Response Example

200
{
  "uuid": "esc-aabbccdd",
  "alertId": "alert-99887766",
  "policyId": "pol-11223344",
  "currentLevel": 2,
  "status": "active",
  "startTime": "example",
  "lastNotify": "example"
}

Change History

This API has no change history records yet.

View all change history