---
title: "List Business Services sorted by impacted status"
method: GET
path: "/business_services/impacts"
tags: ["Business Services"]
---

# List Business Services sorted by impacted status

`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`

## Query parameters

- `additional_fields[]` 'services.highest_impacting_priority' | 'total_impacted_count'
- `ids[]` string

## Headers

- `Accept` string, required

## Response `200`

OK

- object
  - `limit` integer — Echoes limit pagination property.
  - `more` boolean — Indicates if there are additional records to return
  - `services` Impact[]
    - `id` string
    - `name` string
    - `type` 'business_service' — The kind of object that has been impacted
    - `status` 'impacted' | 'not_impacted' — The current impact status of the object
    - `additional_fields` object
      - `highest_impacting_priority` object, nullable — Priority information for the highest priority level that is affecting the impacted object.
        - `id` string
        - `order` integer
  - `additional_fields` object
    - `total_impacted_count` integer

## Other responses

- `400` — Caller provided invalid arguments. Please review the response for error details. Retrying with the same arguments will *not* work.
- `401` — Caller did not supply credentials or did not provide the correct credentials. If you are using an API key, it may be invalid or your Authorization header may be malformed.
- `403` — Caller is not authorized to view the requested resource. While your authentication is valid, the authenticated user or token does not have permission to perform this action.
- `422` — Unprocessable Entity. Some arguments failed validation checks.
- `429` — Too many requests have been made, the rate limit has been reached.

---

[API](https://skmtc.net/pagerduty/apis/rest-api.md) · [All operations](https://skmtc.net/pagerduty/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pagerduty/rest-api/versions/b679a8f3f02c/schema)