Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Connecting external calendars
    4. Advanced guide
  4. Incidents
    1. Get started
    2. Post mortems
    3. Metadata & Catalog
    4. Screening alerts
    5. 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. Uptime API
    1. Getting an API token
    2. Monitors
    3. Heartbeats
    4. On-call & incidents
    5. 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. Response attributes
      6. Status page reports
      7. Status page report updates
    6. Metadata
    7. Integrations
    8. Team members

List status page subscribers

Returns a list of the existing email subscribers of your status page. This endpoint supports pagination.

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

URL parameters

status_page_id
required string

The ID of your status page.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns a list of the subscribers of your status page.

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

Example cURL

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


Looking for the details of a specific parameter?

Explore the list of all status page subscriber API parameters.

Previous article

Response attributes

Next article

Get status page subscriber