Abonnenten einer Status-Seite exportieren

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

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

Beispiel (cURL)

curl "$BASE_URL/api/status-pages/db58058e-4b58-4d97-a314-3bb8e279a182/subscribers/export" \
  -H "Authorization: Bearer $TOKEN" \
  -o subscribers.csv

Antwort

Content-Type: text/csv; charset=utf-8, Content-Disposition: attachment; filename="status-page-<id>-subscribers.csv" (<id> ist die numerische ID der Status-Seite, nicht ihre publicId).

"email","status","locale","created_at","confirmed_at"
"reader@example.com","confirmed","en","2026-08-01T12:00:00.000Z","2026-08-01T12:05:00.000Z"
"other@example.com","pending","de","2026-08-02T09:30:00.000Z",""

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 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