> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Escalation Policies

List all of the existing escalation policies.

Escalation policies define which user should be alerted at which time.

For more information see the ![API Concepts Document](https://developer.pagerduty.com/api-reference/ZG9jOjI3NDc5Nzc-api-concepts#escalation-policies).

## Basic Parameters

<div className="integrations-table">
  | Parameter | Description                                                                                                                              |
  | --------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
  | Include   | Array of additional Models to include in response.                                                                                       |
  | Query     | Filters the result, showing only the tags whose labels match the query.                                                                  |
  | Sort By   | Used to specify the field you wish to sort the results on.                                                                               |
  | Team IDs  | An array of team IDs. Only results related to these teams will be returned. Account must have the `teams` ability to use this parameter. |
  | User IDs  | Filters the results, showing only escalation policies on which any of the users is a target.                                             |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter | Description                                                                                                                                                                                                                                                                               |
  | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Limit     | The number of results per page.                                                                                                                                                                                                                                                           |
  | Offset    | Offset to start pagination search results.                                                                                                                                                                                                                                                |
  | Total     | By default the `total` field in pagination responses is set to `null` to provide the fastest possible response times. Set `total` to `true` for this field to be populated. See our [Pagination Docs](https://developer.pagerduty.com/docs/rest-api-v2/pagination/) for more information. |
</div>

## Example Output

```json theme={"dark"}
{
	"escalation_policies": [
		{
			"id": "PANZZEQ",
			"type": "escalation_policy",
			"summary": "Engineering Escalation Policy",
			"on_call_handoff_notifications": "if_has_services",
			"self": "https://api.pagerduty.com/escalation_policies/PANZZEQ",
			"html_url": "https://subdomain.pagerduty.com/escalation_policies/PANZZEQ",
			"name": "Engineering Escalation Policy",
			"escalation_rules": [
				{
					"id": "PANZZEQ",
					"escalation_delay_in_minutes": 30,
					"targets": [
						{
							"id": "PEYSGVF",
							"summary": "PagerDuty Admin",
							"type": "user_reference",
							"self": "https://api.pagerduty.com/users/PEYSGVF",
							"html_url": "https://subdomain.pagerduty.com/users/PEYSGVF"
						},
						{
							"id": "PI7DH85",
							"summary": "Daily Engineering Rotation",
							"type": "schedule_reference",
							"self": "https://api.pagerduty.com/schedules/PI7DH85",
							"html_url": "https://subdomain.pagerduty.com/schedules/PI7DH85"
						}
					]
				}
			],
			"services": [
				{
					"id": "PIJ90N7",
					"type": "service_reference",
					"summary": "My Mail Service",
					"self": "https://api.pagerduty.com/services/PIJ90N7",
					"html_url": "https://subdomain.pagerduty.com/service-directory/PIJ90N7"
				}
			],
			"num_loops": 0,
			"teams": [
				{
					"id": "PQ9K7I8",
					"type": "team_reference",
					"summary": "Engineering",
					"self": "https://api.pagerduty.com/teams/PQ9K7I8",
					"html_url": "https://subdomain.pagerduty.com/teams/PQ9K7I8"
				}
			]
		}
	],
	"limit": 25,
	"offset": 0,
	"more": false,
	"total": null
}
```

## Workflow Library Example

[List Escalation Policies with Pagerduty and Send Results Via Email](https://library.blinkops.com/workflows/list-escalation-policies-with-pagerduty-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-escalation-policies-with-pagerduty-and-send-results-via-email/canvas" />
</div>