Skip to Content
Uptimeify Docs
Status pages

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

ParameterDescription
idStatus 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.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","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 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 you are an organization-wide caller without the role admin or editor, or your customer scope does not include this status page
  • 403 Forbidden (managed_by_organization) when you are customer-bound (user, also with the role readonly, or token) and the page is managed without the customer's canEditManaged exception
  • 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

On this page