Abonnenten einer Statusseite auflisten
Gibt die E-Mail- und RSS-Abonnenten einer Statusseite zurück, dazu exakte Zählwerte je Status. Org-weit Admin oder Editor, kundengebunden nach der Eigentumsklasse der Seite.
GET /api/status-pages/:id/subscribers
Zugriff: Organisationsweite Aufrufer brauchen die Rolle admin oder editor (organisationsweites readonly bleibt lesend). Kundengebundene Nutzer (auch mit der Rolle readonly) und kundengebundene API-Tokens folgen stattdessen der Eigentumsklasse der Seite: erlaubt auf self_service-Seiten, auf managed-Seiten nur mit der Ausnahme canEditManaged des Kunden, sonst 403 mit data.code: managed_by_organization. Abonnenten-Adressen sind personenbezogene Daten, deshalb braucht das Lesen dasselbe Recht wie das Ändern der Seite.
Pfad-Parameter
| Parameter | Beschreibung |
|---|---|
id | Statusseiten-ID oder publicId (UUID) |
Beispiel (cURL)
curl "$BASE_URL/api/status-pages/db58058e-4b58-4d97-a314-3bb8e279a182/subscribers" \
-H "Authorization: Bearer $TOKEN"Antwort
{
"total": 12,
"confirmed": 9,
"pending": 2,
"unsubscribed": 1,
"disabled": 0,
"subscribers": [
{
"id": 42,
"email": "reader@example.com",
"channel": "email",
"target": null,
"componentIds": null,
"status": "confirmed",
"locale": "en",
"createdAt": "2026-08-01T12:00:00.000Z",
"confirmedAt": "2026-08-01T12:05:00.000Z"
},
{
"id": 43,
"email": null,
"channel": "slack",
"target": "https://hooks.slack.com/…",
"componentIds": [12],
"status": "confirmed",
"locale": "de",
"createdAt": "2026-10-27T09:00:00.000Z",
"confirmedAt": "2026-10-27T09:01:00.000Z"
}
]
}status ist pending, confirmed, unsubscribed oder disabled (ein Webhook-, Slack-, Teams-, SMS- oder Push-Abo, das nach 5 fehlgeschlagenen Zustellungen in Folge abgeschaltet wurde). channel ist email, sms, push, webhook, slack oder teams; außer bei email ist email null, und target trägt nur den Ursprung der Ziel-URL oder des Push-Endpunkts, nie die ganze URL (die URL eines Incoming Webhooks ist das Zugangsgeheimnis), bei sms die Nummer als Ländervorwahl und letzte zwei Ziffern (+49…67). componentIds nennt die Komponenten dieser Seite, denen der Abonnent folgt, null für die ganze Seite. confirmedAt ist null, bis der Abonnent bestätigt hat. total, confirmed, pending, unsubscribed und disabled sind exakte Zählwerte, unabhängig vom subscribers-Array berechnet; subscribers selbst ist auf 5000 Zeilen begrenzt, neueste zuerst, nutze Abonnenten exportieren für die vollständige Liste bei größeren Seiten.
Häufige Fehler
401 Unauthorized, wenn du nicht authentifiziert bist400 User must belong to an organization(data.code: userMustBelongToOrg), wenn sich aus Session oder Token keine Organisation ableiten lässt403 Forbidden, wenn du organisationsweit ohne die Rolle Admin oder Editor aufrufst, oder dein Kunden-Scope diese Statusseite nicht einschließt403 Forbidden(managed_by_organization), wenn du kundengebunden aufrufst (Nutzer, auch mit der Rollereadonly, oder Token) und die Seitemanagedist, ohne die AusnahmecanEditManageddes Kunden400 Invalid Status page identifier, wennidkeine gültige numerische ID oder UUID ist (keindata.code)404 Status page not found, wennidwohlgeformt ist, aber keine Statusseite dazu existiert (keindata.code)404 Status page not found(data.code: statusPageNotFound), wennidsich zu einer echten Statusseite auflöst, diese aber zu einer anderen Organisation gehört oder außerhalb deines Kunden-Scopes liegt
Die letzten beiden Zeilen teilen sich dieselbe Meldung, unterscheiden sich aber im data.code: eine fehlerhafte oder gänzlich unbekannte id trägt nie einen data.code; nur eine id, die sich zu einer Zeile auflöst, die du nicht sehen darfst, tut das.