Abonnenten aller Statusseiten auflisten
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, ü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 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)
curl "$BASE_URL/api/status-pages/subscribers?status=confirmed&perPage=100" \
-H "Authorization: Bearer $TOKEN"Antwort
{
"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: 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 bist403 Forbidden(data.code: forbidden), wenn deine Rolle weder Admin noch Editor ist403 Forbidden(data.code: statusPagesModuleDisabled), wenn das Statusseiten-Modul für deine Organisation nicht aktiv ist400 Bad Request(data.code: invalidRequestBody), wennpage,perPage,channel,statusodersearchungültig ist400 Invalid Status page identifier(data.code: invalidIdentifier), wennstatusPageIdweder numerische ID noch UUID ist