Abonnenten einer Status-Seite auflisten

GET /api/status-pages/:id/subscribers

Pfad-Parameter

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,
  "subscribers": [
    {
      "id": 42,
      "email": "reader@example.com",
      "status": "confirmed",
      "locale": "en",
      "createdAt": "2026-08-01T12:00:00.000Z",
      "confirmedAt": "2026-08-01T12:05:00.000Z"
    }
  ]
}

status ist entweder pending, confirmed oder unsubscribed. confirmedAt ist null, bis der Abonnent seine Adresse bestätigt hat. total, confirmed, pending und unsubscribed 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 deine Rolle nicht Admin oder Editor ist, oder dein Kunden-Scope diese Status-Seite nicht einschließt
• 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 Status-Seite dazu existiert (kein data.code)
• 404 Status page not found (data.code: statusPageNotFound), wenn id sich zu einer echten Status-Seite 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.