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

List status page subscribers

Returns a list of the existing e-mail subscribers of your status page.

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

URL parameters

status_page_id
required string

The ID of your status page.

Query parameters

page
integer

The page number to return, starting with 1.

per_page
integer

Number of results per page. Defaults to 50, maximum 250.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns a list of the subscribers of your status page who haven't unsubscribed.

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"
      }
    }
  ],
  "pagination": {
    "first": "https://incidents.betterstack.com/api/v2/status-pages/987654321/subscribers?page=1",
    "last": "https://incidents.betterstack.com/api/v2/status-pages/987654321/subscribers?page=1",
    "prev": null,
    "next": null
  }
}

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.

pagination.first
string

The URL of the first page. Read more about pagination.

pagination.last
string

The URL of the last page.

pagination.prev
string or null

The URL of the previous page, or null on the first page.

pagination.next
string or null

The URL of the next page, or null on the last page.

Example cURL

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


Previous article

Remove status page resource

Next article

Get status page subscriber