Status Pages API (Authenticated)
Last updated: 2026-05-15
The Status Pages API lets you list all status pages accessible to your account and retrieve the details of a specific status page including its linked monitors.
Base URL
https://statuspage.me/user/api/v1
Authentication
All requests require an API key with at least the status_pages:read scope. Include it as:
Authorization: Bearer spk_...
See API Console for key creation.
Endpoints
List Status Pages
GET /status-pages
Returns all status pages owned by or shared with the authenticated user.
Response
{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Acme Status",
"slug": "acme",
"url": "https://status.acme.com"
}
]
}
| Field | Type | Description |
|---|---|---|
id | string (UUID) | Unique status page ID |
name | string | Display name |
slug | string | The slug used in the default URL (slug.statuspage.me) |
url | string | Custom domain URL (only present if a custom domain is configured) |
Get a Single Status Page
GET /status-pages/:id
Returns a single status page with its linked monitors.
Parameters
| Parameter | Type | Description |
|---|---|---|
id | string (UUID) | The status page ID |
Response
{
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Acme Status",
"slug": "acme",
"monitors": [
{
"id": 42,
"name": "API Gateway",
"type": "site",
"target": "https://api.acme.com/health",
"interval_seconds": 60,
"enabled": true
}
]
}
}
Monitor fields
| Field | Type | Description |
|---|---|---|
id | integer | Monitor ID |
name | string | Monitor display name |
type | string | site, api, dns, or heartbeat |
target | string | The URL, hostname, or endpoint being monitored |
interval_seconds | integer | How often the monitor runs (in seconds) |
enabled | boolean | Whether the monitor is currently active |
Error Responses
| Status | Meaning |
|---|---|
401 Unauthorized | Missing or invalid API key |
403 Forbidden | Key lacks the required scope |
404 Not Found | Status page not found or you don’t have access |