Export Status Page Subscribers

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

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

Example (cURL)

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

Response

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

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 Unauthorized when you are not authenticated
• 400 User must belong to an organization (data.code: userMustBelongToOrg) when no organization can be derived from the session or token
• 403 Forbidden when your role is not admin or editor, or your customer scope does not include this status page
• 400 Invalid Status page identifier when id is not a valid numeric ID or UUID (no data.code)
• 404 Status page not found when id is well-formed but no status page has that ID (no data.code)
• 404 Status page not found (data.code: statusPageNotFound) when id resolves to a real status page, but it belongs to a different organization, or is outside your customer scope