Status API

Read your monitors, uptime history and incidents over a small, predictable REST API. Bearer auth, JSON in and out.

Authentication

Send your project token as a bearer header on every request. Tokens are scoped per project and can be rotated from the dashboard.

# every request carries your token
curl https://api.example.com/v1/monitors \
  -H "Authorization: Bearer pls_live_•••••"

Endpoints

GET/v1/monitorsList every monitor and its current state
GET/v1/monitors/:idOne monitor with 90-day uptime
GET/v1/incidentsOpen and resolved incidents
POST/v1/monitorsCreate a monitor

Example response

A monitor object reports its latest check, the rolling uptime ratio and the region that ran the probe.

{
  "id": "mon_8f2a",
  "name": "API Gateway",
  "state": "operational",
  "uptime_90d": 0.9998,
  "response_ms": 118,
  "region": "fra-1",
  "checked_at": "2026-06-09T01:14:22Z"
}

Rate limits

Read endpoints allow 600 requests per minute per token. Writes allow 60 per minute. Every response carries X-RateLimit-Remaining so you can back off cleanly.

Webhooks

Subscribe to monitor.down, monitor.up and incident.opened to push state changes into your own systems. Payloads are signed with your endpoint secret.

{
  "event": "monitor.down",
  "monitor": "mon_8f2a",
  "confirmed_from": ["fra-1", "iad-2", "sin-1"],
  "at": "2026-06-09T01:14:51Z"
}