GET /business_services/impacts

Retrieve a list top-level Business Services sorted by highest Impact with status included. When called without the ids[] parameter, this endpoint does not return an exhaustive list of Business Services but rather provides access to the most impacted up to the limit of 200.

The returned Business Services are sorted first by Impact, secondarily by most recently impacted, and finally by name.

To get impact information about a specific set of Business Services, use the ids[] parameter. Scoped OAuth requires: services.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"

Query parameters

Name Type Required Description
ids String No

The IDs of the resources.

additional_fields String No

Provides access to additional fields such as highest priority per business service and total impacted count

Possible values:

  • "total_impacted_count"
  • "services.highest_impacting_priority"

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.