---
title: "List escalations"
method: GET
path: "/api/{cloudId}/v1/teams/{teamId}/escalations"
tags: ["Escalations"]
---

# List escalations

`GET /api/{cloudId}/v1/teams/{teamId}/escalations`

Lists all escalations under given team. It optionally takes two parameters - offset and size.

## Path parameters

- `teamId` string, required

## Query parameters

- `offset` integer
- `size` integer

## Response `200`

Returned if the request is successful.

- EscalationPaginatedResponse
  - `values` EscalationResponse[]
    - `id` string — Identifier of the escalation.
    - `name` string — Name of the escalation.
    - `description` string — Description of the escalation.
    - `rules` EscalationRuleResponse[] — List of the escalation rules.
      - `condition` 'if-not-acked' | 'if-not-closed' — The condition for notifying the recipient of escalation rule that is based on the alert state.
      - `notifyType` 'default' | 'next' | 'previous' | 'users' | 'admins' | 'all' | 'random' — Recipient calculation logic for escalations. Possible values are: <br /> <b>default</b>: on call users <br /> <b>next</b>: next users in rotation <br /> <b>previous</b>: previous users on rotation <br /> <b>users</b>: users of the team <br /> <b>admins</b>: admins of the team <br /> <b>random</b>: randomly in the team <br /> <b>all</b>: all members of the team.
      - `delay` integer — Time delay of the escalation rule in minutes.
      - `recipient` object — Object of schedule, team, or users which will be notified in escalation.
        - `id` string
        - `type` 'user' | 'schedule' | 'team'
    - `enabled` boolean
    - `repeat` EscalationRepeat — Repeat preferences of the escalation including repeat interval, count, reverting acknowledge and seen states back and closing an alert automatically as soon as repeats are completed.
      - `waitInterval` integer — The duration in minutes to repeat the escalation rules after processing the last escalation rule. It is mandatory if you would like to add or remove repeat option. 0 should be given as a value to disable repeat option.
      - `count` integer — Repeat time indicating how many times the repeat action will be performed.
      - `resetRecipientStates` boolean — It is for reverting <b>acknowledge</b> and <b>seen</b> states back on each repeat turn if an alert is not closed.
      - `closeAlertAfterAll` boolean — It is to close the alert automatically if escalation repeats are completed.
  - `links` EscalationLinks
    - `next` string — Link to the next page of results.

## Other responses

- `401` — Returned if the authentication credentials are incorrect.
- `403` — Returned if the request user does not have read-only permission for escalations.
- `404` — Returned if the escalation owning team is not found.

---

[API](https://skmtc.net/atlassian/apis/jsm-operations-api.md) · [All operations](https://skmtc.net/atlassian/apis/jsm-operations-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/jsm-operations-api/versions/ed65f017bcb8/schema)