GET /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

Scoped OAuth requires: escalation_policies.read

Servers

Request headers

Name Type Required Description
Accept String Yes

The Accept header is used as a versioning header.

Default value: "application/vnd.pagerduty+json;version=2"

Content-Type String Yes

Possible values:

  • "application/json"

Default value: "application/json"

Query parameters

Name Type Required Description
query String No

Filters the result, showing only the records whose name matches the query.

limit Integer No

The number of results per page.

include String No

Array of additional Models to include in response.

Possible values:

  • "services"
  • "teams"
  • "targets"
user_ids[] Array No

Filters the results, showing only escalation policies on which any of the users is a target.

team_ids[] Array No

An array of team IDs. Only results related to these teams will be returned. Account must have the teams ability to use this parameter.

sort_by String No

Used to specify the field you wish to sort the results on.

Possible values:

  • "name:asc"
  • "name"
  • "name:desc"

Default value: "name"

offset Integer No

Offset to start pagination search results.

total Boolean No

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.

Default value: false

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.