---
title: "Get a specific escalation policy"
method: GET
path: "/api-public/v1/policies/{policy}"
tags: ["Escalation Policies"]
---

# Get a specific escalation policy

`GET /api-public/v1/policies/{policy}`

Gets a specific escalation policy based on the unique policy slug provided in the path.

The context for which team this policy belongs to is not available at this level. To retrieve information about this escalation policy's team, you must retrieve all of the policy summaries. The escalation policy summaries include links to this endpoint for each escalation policy.

This API may be called a maximum of 2 times per second.

## Path parameters

- `policy` string, required

## Headers

- `X-VO-Api-Id` string, required
- `X-VO-Api-Key` string, required

## Response `200`

The escalation policy matching the provided slug

- EscalationPolicy
  - `name` string, required — The name of this escalation policy
  - `slug` string, required — A unique identifier for this escalation polcy This slug is in the format `pol-[\w\d]{16}`
  - `ignoreCustomPagingPolicies` boolean, required — True if this policy ignores a user's custom paging policy; this will page the on-call user via their Primary Paging Policy and ignore any custom paging policies they have set. We recommend enabling this if the escalation policy handles high severity incidents.
  - `steps` EscalationPolicyGroup[], required — A list of groupings of entries. Each group is a "step" in the escalation policy. Each "step" contains a group of entries to be executed.
    - `timeout` integer, required — The duration in minutes to wait until executing this step since the last step was executed. This value may be 0. This implies that this policy step should immediately execute.
    - `entries` EscalationPolicyEntry[], required — A list of entries that this escalation policy group encapsulates. These entries will all be executed once the escalation policy reaches this step.
      - `executionType` 'rotation_group' | 'rotation_group_next' | 'rotation_group_previous' | 'webhook' | 'user' | 'email' | 'policy_routing', required — The type of entry
      - `rotationGroup` object
        - `slug` string — The unique identifier for the rotation group that will be executed when this escalation policy step activates. The slug is in the format `rtg-[\w\d]{16}` To get more information about this rotation group, you can use the endpoints available in the Rotation Groups section
        - `label` string — The name of the rotation group
      - `webhook` object
        - `slug` string — The unique identifier for the webhook that will be executed when this escalation policy step activates The slug is in the format `wh-[\w\d]{16}` To get more information about this webhook, you can use the endpoints available in the Webhooks section
        - `label` string — The name of the webhook
      - `user` object
        - `username` string — The unique identifier for the user. This user will be notified when the escalation policy step activates.
        - `firstName` string — The user's first name
        - `lastName` string — The user's last name
      - `email` object
        - `address` string — The email address that will be notified when this escalation policy step activates.
      - `targetPolicy` object — The escalation policy to target when executing
        - `policySlug` string — The unique slug of another escalation policy that will be executed when this escalation policy step activates. The policy slug is in the format `pol-[\w\d]{16}`

## Other responses

- `400` — Problem with the request arguments. The response payload may include an error message.
- `401` — Authentication parameters missing
- `403` — Authentication failed or rate-limit reached
- `404` — Path not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/victorops/apis/victorops-api.md) · [All operations](https://skmtc.net/victorops/apis/victorops-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/victorops/victorops-api/revisions/7a7391256058/schema)