Explore documentation
  1. Welcome to Incidents 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Tag on-call in Slack
    4. Mobile apps ↗
    5. Connecting external calendars
    6. Advanced guide
  4. Incident management
    1. Get started
    2. AI SRE investigations
    3. Post mortems
    4. Metadata & Catalog
    5. Screening alerts
    6. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Incidents API
    1. Getting an API token
    2. Pagination
    3. Monitors
    4. Heartbeats
    5. On-call & incidents
    6. Status pages
      1. Status pages API
      2. Status page groups
      3. Status page sections
      4. Status page resources
      5. Status page subscribers
        1. List status page subscribers GET
        2. Get status page subscriber GET
        3. Create status page subscriber POST
        4. Update status page subscriber PATCH
        5. Remove status page subscriber DELETE
      6. Status page reports
      7. Status page report updates
    7. Metadata
    8. Integrations
    9. Team members
    10. Organization roles
    11. Usage
    12. Reporting

Get status page subscriber

Returns a single e-mail subscriber of your status page.

GET https://incidents.betterstack.com/api/v2/status-pages/{status_page_id}/subscribers/{subscriber_id}

URL parameters

status_page_id
required string

The ID of your status page.

subscriber_id
required string

The ID of the subscriber.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns the status page subscriber.

Response body

{
  "data": {
    "id": "123456789",
    "type": "status_page_subscriber",
    "attributes": {
      "status_page_id": 987654321,
      "email": "customer@example.com",
      "status_page_resource_ids": [],
      "confirmed_at": "2026-04-29T14:30:00.000Z",
      "created_at": "2026-04-29T14:30:00.000Z",
      "updated_at": "2026-04-29T14:30:00.000Z"
    }
  }
}

Response attributes

id
string

The ID of the status page subscriber.

type
string

Always status_page_subscriber.

attributes.status_page_id
integer

ID of the status page.

attributes.email
string

E-mail address of the subscriber.

attributes.status_page_resource_ids
array of integers

IDs of the status page resources the subscriber gets updates for. Empty means all resources.

attributes.confirmed_at
string or null

When the subscriber confirmed their e-mail address, in ISO 8601 format. Subscribers created through the API are confirmed immediately, and null means not confirmed yet.

attributes.created_at
string

When the subscriber was created, in ISO 8601 format.

attributes.updated_at
string

When the subscriber was last updated, in ISO 8601 format.

Example cURL

Example
curl --request GET \
  --url https://incidents.betterstack.com/api/v2/status-pages/987654321/subscribers/123456789 \
  --header "Authorization: Bearer $TOKEN"


Previous article

List status page subscribers

Next article

Create status page subscriber