Skip to Content
Uptimeify Docs

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

ParameterBeschreibung
idStatusseiten-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 bist
  • 400 User must belong to an organization (data.code: userMustBelongToOrg), wenn sich aus Session oder Token keine Organisation ableiten lässt
  • 403 Forbidden, wenn du organisationsweit ohne die Rolle Admin oder Editor aufrufst, oder dein Kunden-Scope diese Statusseite nicht einschließt
  • 403 Forbidden (managed_by_organization), wenn du kundengebunden aufrufst (Nutzer, auch mit der Rolle readonly, oder Token) und die Seite managed ist, ohne die Ausnahme canEditManaged des Kunden
  • 400 Invalid Status page identifier, wenn id keine gültige numerische ID oder UUID ist (kein data.code)
  • 404 Status page not found, wenn id wohlgeformt ist, aber keine Statusseite dazu existiert (kein data.code)
  • 404 Status page not found (data.code: statusPageNotFound), wenn id sich 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.

Auf dieser Seite