---
title: "GET /alerts/groups"
method: GET
path: "/alerts/groups"
tags: ["alertgroup"]
---

# GET /alerts/groups

`GET /alerts/groups`

Get a list of alert groups

## Query parameters

- `active` boolean
- `silenced` boolean
- `inhibited` boolean
- `muted` boolean
- `filter` string[]
- `receiver` string
- `receiver_matchers` string[]

## Response `200`

Get alert groups response

- AlertGroup[]
  - `labels` LabelSet, required
  - `routeLabels` LabelSet, required
  - `receiver` ReceiverReference, required
    - `name` string, required
  - `alerts` GettableAlert[], required
    - `annotations` LabelSet, required
    - `receivers` ReceiverReference[], required
      - `name` string, required
    - `fingerprint` string, required
    - `startsAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `endsAt` string, date-time, required
    - `status` AlertStatus, required
      - `state` 'unprocessed' | 'active' | 'suppressed', required
      - `silencedBy` string[], required
      - `inhibitedBy` string[], required
      - `mutedBy` string[], required
    - `labels` LabelSet, required
    - `generatorURL` string, uri

## Other responses

- `400` — Bad request
- `500` — Internal server error

## Changes

- **2026-05-23** (v2) `fa8d49dd6478` — 1 info
  - added the new optional `query` request parameter `receiver_matchers`
- **2024-10-23** (v2) `ff0e9cccc316` — 1 info
  - added the new optional `query` request parameter `muted`
- **2021-09-10** (v2) `9cab89e8f772` — 1 info
  - endpoint added
- **2021-09-10** (v2) `b67fa626591b` — 1 breaking
  - api path removed without deprecation
- **2019-03-07** (v2) `e58b2269924d` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/prometheus/apis/alertmanager-api/changes/alerts/groups/get.md)

---

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