Monitors API

Read your monitors and their availability metrics using the authenticated API. Requires the monitors:read scope (or full-access key).

List all monitors

GET /user/api/v1/monitors

Required scope: monitors:read

Example:

curl -H "Authorization: Bearer spk_..." \
  https://statuspage.me/user/api/v1/monitors

Response:

{
  "data": [
    {
      "id": 42,
      "name": "API endpoint",
      "type": "site",
      "target": "https://api.example.com/health",
      "interval_seconds": 60,
      "enabled": true,
      "status_page_id": "550e8400-e29b-41d4-a716-446655440000",
      "status_page_slug": "my-company",
      "created_at": "2025-11-01T10:00:00Z",
      "updated_at": "2026-03-01T08:30:00Z"
    }
  ]
}

Get a single monitor

GET /user/api/v1/monitors/:id

Required scope: monitors:read

Get monitor availability metrics

GET /user/api/v1/monitors/:id/availability?period=30d

Required scope: analytics:read

Query parameters:

Example:

curl -H "Authorization: Bearer spk_..." \
  "https://statuspage.me/user/api/v1/monitors/42/availability?period=30d"

Response includes uptime percentage, MTTR (mean time to recovery), MTBF (mean time between failures), and downtime data for the requested period.

Notes

• Monitors belonging to status pages accessible via team membership are included.
• Disabled monitors are excluded from the list.