---
title: "Get a list of escalation policy info"
method: GET
path: "/api-public/v1/policies"
tags: ["Escalation Policies"]
---

# Get a list of escalation policy info

`GET /api-public/v1/policies`

Retrieves a list of all escalation policy summaries and their associated teams that exist in your organization.
If the optional `filter` query parameter is present, retrieves a list of all escalation policy summaries with a name matching the provided search filter.

This is the recommended way for determining to which team an escalation policy belongs.

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

## Query parameters

- `filter` string

## Headers

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

## Response `200`

A list of escalation policy info objects, each of which contain a summary of an escalation policy and a summary for the team associated with that escalation policy.

- EscalationPolicyInfoList
  - `policies` EscalationPolicyInfo[], required — A list of escalation policy info objects
    - `policy` EscalationPolicySummary, required — A summary containing minimal, high-level information about an escalation policy.
      - `name` string, required — The name of this escalation policy
      - `slug` string, required — A unique identifier for this escalation policy. The slug is in the format `pol-[\w\d]{16}`
      - `_selfUrl` string, required — This is a URI that is generated for this escalation policy. It points to the entire escalation policy resource. and can be used to get detailed information about this escalation policy instead of just the summary.
    - `team` Team, required
      - `name` string, required — The team name
      - `slug` string, required — The unique identifier for this team. The slug is in the format `team-[\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)