Export Status Page Subscribers
Downloads every subscriber of a status page as CSV. Organization-wide: admin or editor; customer-bound: by the page's ownership class.
GET /api/status-pages/:id/subscribers/export
Access: Organization-wide callers need the role admin or editor (organization-wide readonly stays read-only). Customer-bound users (also with the role readonly) and customer-bound API tokens follow the page's ownership class instead: allowed on self_service pages, on managed pages only with the customer's canEditManaged exception, otherwise 403 with data.code: managed_by_organization. Subscriber addresses are personal data, so reading them takes the same right as changing the page.
Unlike List Status Page Subscribers, the export is not capped, it returns every row for the page. Each export is recorded in the organization's audit log (page ID and row count only, never the addresses themselves), since this is a bulk download of your subscribers' personal data.
Path Parameter
| Parameter | Description |
|---|---|
id | Status page ID or publicId (UUID) |
Example (cURL)
curl "$BASE_URL/api/status-pages/db58058e-4b58-4d97-a314-3bb8e279a182/subscribers/export" \
-H "Authorization: Bearer $TOKEN" \
-o subscribers.csvResponse
Content-Type: text/csv; charset=utf-8, Content-Disposition: attachment; filename="status-page-<id>-subscribers.csv" (<id> is the status page's numeric ID, not its 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 and component_ids follow the original five columns. target is the origin of a webhook, Slack, Teams or push target only, never the full URL, and for SMS the masked number (+49…67); component_ids is a space separated list, empty for the whole page.
Rows are ordered newest-first by created_at. Every field is quoted and embedded quotes are doubled per RFC 4180. A value that would otherwise start with =, +, -, or @, or with these characters when preceded by whitespace (tab, space, or carriage return), is prefixed with a single quote so it renders as inert text instead of being evaluated. Subscriber emails are visitor-supplied, so this guards against CSV/formula injection when the file is opened in Excel or Sheets.
Common errors
401 Unauthorizedwhen you are not authenticated400 User must belong to an organization(data.code: userMustBelongToOrg) when no organization can be derived from the session or token403 Forbiddenwhen you are an organization-wide caller without the role admin or editor, or your customer scope does not include this status page403 Forbidden(managed_by_organization) when you are customer-bound (user, also with the rolereadonly, or token) and the page ismanagedwithout the customer'scanEditManagedexception400 Invalid Status page identifierwhenidis not a valid numeric ID or UUID (nodata.code)404 Status page not foundwhenidis well-formed but no status page has that ID (nodata.code)404 Status page not found(data.code: statusPageNotFound) whenidresolves to a real status page, but it belongs to a different organization, or is outside your customer scope
Delete Status Page Subscriber
Permanently deletes a subscriber and its stored consent evidence. Organization-wide: admin or editor; customer-bound: by the page's ownership class.
List Subscribers of All Status Pages
Returns the subscribers of every status page you may manage in one paged list, with filters. Organization-wide: admin or editor; customer-bound: the pages you may maintain.