---
title: "Komponentengruppen auflisten"
description: "Gibt alle Komponentengruppen einer Status-Seite zurück, sortiert nach sort."
---

`GET /api/status-pages/{id}/groups`

Gruppen fassen [Komponenten](/de/api/status-pages/list-status-page-components) auf der öffentlichen Seite unter einer Überschrift zusammen. Die Liste enthält alle Gruppen der Seite auf einer einzigen Ergebnisseite, sortiert nach `sort`, dann `id`. Eine Seite hat höchstens 100 Gruppen.

## Zugriff

Organisations-`admin`, `editor` und `readonly`. Ein kundengebundener Nutzer oder API-Token erreicht nur Seiten eines Kunden in seinem Bereich; eine Seite ohne Kunde (`customerId: null`) beantwortet ihm `403` (`forbidden`). Eine Seite einer anderen Organisation antwortet `404` (`statusPageNotFound`). `:id` nimmt die numerische ID oder die `publicId` der Status-Seite.

## Beispiel (cURL)

```bash
BASE_URL="https://uptimeify.io"
TOKEN="<dein-api-token>"

curl -X GET "$BASE_URL/api/status-pages/1/groups" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"
```

## Antwort

`200 OK`

```json
{
  "items": [
    {
      "id": 3,
      "publicId": "9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b",
      "statusPageId": 1,
      "name": "Core services",
      "sort": 0,
      "collapsed": false,
      "createdAt": "2026-10-27T08:55:00.000Z",
      "updatedAt": "2026-10-27T08:55:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "perPage": 1
}
```

`collapsed` legt fest, ob die Gruppe auf der öffentlichen Seite zugeklappt startet.

## Häufige Fehler

- `400 Bad Request` (`invalidIdentifier`), wenn eine ID im Pfad weder Zahl noch UUID ist
- `401 Unauthorized`, wenn du nicht angemeldet bist
- `403 Forbidden` (`forbidden`), wenn deine Rolle das nicht darf, oder für einen kundengebundenen Aufrufer auf einer Seite ohne Kunde oder eines anderen Kunden
- `403 Forbidden` (`statusPagesModuleDisabled`), wenn das Statusseiten-Modul nicht aktiviert ist
- `404 Not Found` (`statusPageNotFound`), wenn die Status-Seite nicht existiert oder zu einer anderen Organisation gehört