---
title: "List alert grouping settings"
method: GET
path: "/alert_grouping_settings"
tags: ["Alert Grouping Settings"]
---

# List alert grouping settings

`GET /alert_grouping_settings`

List all of your alert grouping settings including both single service settings and global content based settings.

The settings part of Alert Grouper service allows us to create Alert Grouping Settings and configs that are required to be used during grouping of the alerts.

Scoped OAuth requires: `services.read`

## Query parameters

- `after` string
- `before` string
- `total` boolean
- `limit` integer
- `service_ids[]` string[]

## Headers

- `Accept` string, required
- `Content-Type` 'application/json', required

## Response `200`

An array of alert grouping settings.

- object
  - `alert_grouping_settings` AlertGroupingSetting[], required — The list of alert grouping settings your account has. — unresolved $ref

## Other responses

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

---

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