Skip to Content
Uptimeify Docs

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

ParameterBeschreibung
idStatusseiten-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.csv

Antwort

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

Auf dieser Seite