Docs

Type a word or a question. Esc closes the search.

Sign in Start free

List status page subscribers

Returns subscriber addresses, channels, filters and delivery status for a status page.

GET https://app.upfour.io/v1/status-pages/{pageID}/subscribers
GET https://app.upfour.io/v1/status-pages/{pageID}/subscribers
Authorization
AuthorizationA pls_ key. It stays in this browser tab. Needs status_page.read.
Path

Sent directly from your browser to https://app.upfour.io/v1. Mutating calls get an automatic Idempotency-Key when the field is empty.

Request
Responsenot sent yet
Fill in a key and press Send request (⌘↵).
The answer appears here.
scope status_page.read stable returns 200

Parameters

FieldTypeDescription
pageID required uuid path parameter

Returns

A successful request returns 200 with application/json.

Response fields 2 top-level fields
FieldTypeDescription
data StatusPageSubscriber[] · nullable
Each item · 15 fields
FieldTypeDescription
channel string one ofemailwebhook
confirmed boolean
created_at string (date-time)
email string
failure_count integer
id uuid
resource_ids uuid[] · nullable
status_page_id uuid
subscribed_to string one ofallincidentmaintenance
disabled_at string (date-time)
last_delivery_at string (date-time)
last_failure_at string (date-time)
suppression string one ofhard_bouncecomplaint Why nothing is mailed to the address; empty when it is not suppressed.
suppression_liftable boolean True for a hard bounce, which an owner or admin may release; a complaint stays with up4.
webhook_target string The webhook URL in masked form; never the full URL or its secret.
pagination Pagination
Pagination · 5 fields
FieldTypeDescription
cursor string · nullable
has_more boolean
limit integer 1–250
next_cursor string · nullable
prev_cursor string · nullable

Errors

Only the errors this operation can return. Every error uses the same envelope.

Status Code Meaning
400 bad_request The request is malformed or fails validation.
404 not_found The requested resource does not exist or is outside the caller's scope.

Every call can also return unauthorized (401), rate_limit_exceeded (429) or internal_error (500 / 502). See Responses and errors.