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 .
Basic Parameters
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. |
Advanced Parameters
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 for more information. |
Example Output
{
"summary": "Response Example",
"value": {
"escalation_policies": [
{
"escalation_rules": [
{
"escalation_delay_in_minutes": 30,
"id": "PANZZEQ",
"targets": [
{
"html_url": "https://subdomain.pagerduty.com/users/PEYSGVF",
"id": "PEYSGVF",
"self": "https://api.pagerduty.com/users/PEYSGVF",
"summary": "PagerDuty Admin",
"type": "user_reference"
},
{
"html_url": "https://subdomain.pagerduty.com/schedules/PI7DH85",
"id": "PI7DH85",
"self": "https://api.pagerduty.com/schedules/PI7DH85",
"summary": "Daily Engineering Rotation",
"type": "schedule_reference"
}
]
}
],
"html_url": "https://subdomain.pagerduty.com/escalation_policies/PANZZEQ",
"id": "PANZZEQ",
"name": "Engineering Escalation Policy",
"num_loops": 0,
"on_call_handoff_notifications": "if_has_services",
"self": "https://api.pagerduty.com/escalation_policies/PANZZEQ",
"services": [
{
"html_url": "https://subdomain.pagerduty.com/services/PIJ90N7",
"id": "PIJ90N7",
"self": "https://api.pagerduty.com/services/PIJ90N7",
"summary": "My Mail Service",
"type": "service_reference"
}
],
"summary": "Engineering Escalation Policy",
"teams": [
{
"html_url": "https://subdomain.pagerduty.com/teams/PQ9K7I8",
"id": "PQ9K7I8",
"self": "https://api.pagerduty.com/teams/PQ9K7I8",
"summary": "Engineering",
"type": "team_reference"
}
],
"type": "escalation_policy"
}
],
"limit": 25,
"more": false,
"offset": 0,
"total": null
}
}
Workflow Library Example
List Escalation Policies with Pagerduty and Send Results Via Email