Subscribers API

View subscribers who have signed up for email notifications from your status page.

[
  {
    "id": "a1b2c3d4e5f6...",
    "organization_id": "org_id_here",
    "email": "subscriber@example.com",
    "confirmed": true,
    "created_at": "2026-02-20T10:30:00Z"
  }
]

Subscriber Object

• id — unique subscriber identifier
• organization_id — the organization they are subscribed to
• email — subscriber's email address
• confirmed — whether the email has been confirmed
• created_at — when they subscribed

How Notifications Are Sent

When an incident event occurs, the core service creates notification records for each subscriber. The alerter service polls for pending notifications every 10 seconds and sends emails via SMTP. Each notification tracks its delivery status as pending, sent, or failed.