---
title: "Abonnenten aller Statusseiten auflisten"
description: "Liefert die Abonnenten aller Statusseiten, die du verwalten darfst, in einer gefilterten, seitenweisen Liste. Erfordert Admin- oder Editor-Rolle."
---

`GET /api/status-pages/subscribers`

Dieselben Zeilen wie [Abonnenten auflisten](/de/api/status-pages/list-subscribers), über alle Seiten: genau die Statusseiten, deren Abonnentenliste du auch einzeln öffnen dürftest (deine Organisation, dein Kundenumfang; Seiten ohne Kunde nur mit organisationsweitem Umfang). Anlegen lassen sich Abonnenten über die API nicht: ein Abonnement entsteht erst, wenn der Empfänger es bestätigt hat (Double-Opt-in). Zum Entfernen dient [Abonnent löschen](/de/api/status-pages/delete-subscriber) mit der `statusPagePublicId` der Zeile.

## Query-Parameter

| Parameter | Beschreibung |
|-----------|-------------|
| `page` | Seitennummer, Vorgabe `1` |
| `perPage` | Zeilen je Seite, Vorgabe `50`, höchstens `200` |
| `statusPageId` | Nur diese Statusseite (ID oder `publicId`). Eine unbekannte Seite oder eine außerhalb deines Umfangs ergibt eine leere Liste |
| `channel` | `email`, `sms`, `push`, `webhook`, `slack` oder `teams` |
| `status` | `pending`, `confirmed`, `unsubscribed` oder `disabled` |
| `search` | Sucht ohne Beachtung der Groß-/Kleinschreibung in E-Mail-Adresse und Name der Statusseite (höchstens 200 Zeichen) |

## Beispiel (cURL)

```bash
curl "$BASE_URL/api/status-pages/subscribers?status=confirmed&perPage=100" \
  -H "Authorization: Bearer $TOKEN"
```

## Antwort

```json
{
  "items": [
    {
      "id": 43,
      "statusPageId": 7,
      "statusPagePublicId": "db58058e-4b58-4d97-a314-3bb8e279a182",
      "statusPageName": "Acme Status",
      "email": null,
      "channel": "slack",
      "target": "https://hooks.slack.com/…",
      "componentIds": [12],
      "componentNames": ["Checkout"],
      "status": "confirmed",
      "locale": "de",
      "createdAt": "2026-10-27T09:00:00.000Z",
      "confirmedAt": "2026-10-27T09:01:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "perPage": 100
}
```

Neueste zuerst. Die Felder bedeuten dasselbe wie bei [Abonnenten auflisten](/de/api/status-pages/list-subscribers): `email` ist bei den URL-Kanälen `null`, `target` enthält nur den Ursprung der Ziel-URL, nie die ganze URL. `componentNames` nennt die Namen zu `componentIds` in derselben Reihenfolge; beide sind `null`, wenn der Abonnent der ganzen Seite folgt.

## Häufige Fehler

- `401 Unauthorized`, wenn du nicht angemeldet bist
- `403 Forbidden` (`data.code: forbidden`), wenn deine Rolle weder Admin noch Editor ist
- `403 Forbidden` (`data.code: statusPagesModuleDisabled`), wenn das Statusseiten-Modul für deine Organisation nicht aktiv ist
- `400 Bad Request` (`data.code: invalidRequestBody`), wenn `page`, `perPage`, `channel`, `status` oder `search` ungültig ist
- `400 Invalid Status page identifier` (`data.code: invalidIdentifier`), wenn `statusPageId` weder numerische ID noch UUID ist