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

---

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