# List status page subscribers

Returns a list of the existing email subscribers of your status page. This endpoint [supports pagination](https://betterstack.com/docs/uptime/api/pagination/).

[endpoint]
method = "GET"
base_url = "https://uptime.betterstack.com"
path = "/api/v2/status-pages/{status_page_id}/subscribers"

[[path_param]]
name = "status_page_id"
type = "string"
required = true
description = "The ID of your status page."

[[header]]
name = "Authorization"
type = "string"
required = true
description = "Bearer `$TOKEN`"
[/endpoint]

[responses]
[[response]]
status = 200
description = "Returns a list of the subscribers of your status page."
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
  }
}
'''
[/responses]

#### Example cURL

```bash
[label 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](https://betterstack.com/docs/uptime/api/status-pages-subscribers-api-response-params/).