Abonnenten einer Statusseite exportieren
Lädt alle Abonnenten einer Statusseite als CSV herunter. Org-weit Admin oder Editor, kundengebunden nach der Eigentumsklasse der Seite.
GET /api/status-pages/:id/subscribers/export
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.
Anders als Abonnenten auflisten ist der Export nicht begrenzt, er liefert alle Zeilen der Seite. Jeder Export wird im Audit-Log deiner Organisation festgehalten (nur Seiten-ID und Zeilenanzahl, nie die Adressen selbst), da es sich um einen Massenexport der personenbezogenen Daten deiner Abonnenten handelt.
Pfad-Parameter
| Parameter | Beschreibung |
|---|---|
id | Statusseiten-ID oder publicId (UUID) |
Beispiel (cURL)
curl "$BASE_URL/api/status-pages/db58058e-4b58-4d97-a314-3bb8e279a182/subscribers/export" \
-H "Authorization: Bearer $TOKEN" \
-o subscribers.csvAntwort
Content-Type: text/csv; charset=utf-8, Content-Disposition: attachment; filename="status-page-<id>-subscribers.csv" (<id> ist die numerische ID der Statusseite, nicht ihre publicId).
"email","status","locale","created_at","confirmed_at","channel","target","component_ids"
"reader@example.com","confirmed","en","2026-08-01T12:00:00.000Z","2026-08-01T12:05:00.000Z","email","",""
"other@example.com","pending","de","2026-08-02T09:30:00.000Z","","email","",""
"","confirmed","de","2026-10-27T09:00:00.000Z","2026-10-27T09:01:00.000Z","slack","https://hooks.slack.com/…","12 14"channel, target und component_ids stehen hinter den ursprünglichen fünf Spalten. target ist nur der Ursprung eines Webhook-, Slack-, Teams- oder Push-Ziels, nie die ganze URL, bei SMS die maskierte Nummer (+49…67); component_ids ist eine durch Leerzeichen getrennte Liste, leer für die ganze Seite.
Die Zeilen sind nach created_at absteigend sortiert, neueste zuerst. Jedes Feld ist in Anführungszeichen gesetzt, enthaltene Anführungszeichen werden gemäß RFC 4180 verdoppelt. Ein Wert, der sonst mit =, +, - oder @ beginnen würde, oder mit diesen Zeichen, denen Whitespace vorangeht (Tab, Leerzeichen oder Wagenrücklauf), erhält ein führendes einfaches Anführungszeichen, sodass er als reiner Text und nicht als Formel ausgewertet wird. Die E-Mail-Adressen stammen von Website-Besuchern und sind damit nicht vertrauenswürdig, das schützt beim Öffnen der Datei in Excel oder Sheets vor CSV-/Formel-Injection.
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
Abonnenten aller Statusseiten exportieren
Lädt die Abonnenten der ausgewählten Statusseiten als CSV herunter, mit denselben Filtern wie die Liste. Org-weit Admin oder Editor, kundengebunden die Seiten, die du pflegen darfst.
Öffentliche Statusseite abfragen
Zwei Endpunkte liefern die öffentliche Statusseiten-Ansicht: