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

Preview this Workflow on desktop