Status Pages API

Status pages publish the live health of selected monitors at a public (or private) URL. This page documents the public status endpoint that any client can read without authentication, plus the User API endpoints for listing and reading your status pages.

There are three distinct surfaces, and they do not share the same host or auth:

Status pages themselves are created and edited from the dashboard, not the API — the User API exposes them read-only. See Managing status pages.

Public Status Endpoint

GET /api/status/{slug}

Returns the published state of a status page identified by its slug. No authentication. Only pages with is_public = true are served; a private or unknown slug returns 404.

curl https://api.statusradar.dev/v1/status/my-status-page

Path parameters

Response fields

The payload describes the page and the monitors assigned to it.

theme object

monitors[] object

Each monitor entry combines the monitor definition with its per-page display settings and live status.

uptime_history[] object

Example response

{
  "slug": "my-status-page",
  "title": "Acme Status",
  "description": "Live status of the Acme platform.",
  "is_public": true,
  "language": "en",
  "show_history_days": 90,
  "theme": {
    "primary_color": "#10b981",
    "layout": "modern-light"
  },
  "overall_status": "operational",
  "monitors": [
    {
      "id": 42,
      "name": "API",
      "display_name": "Public API",
      "group_name": "Core",
      "current_status": "operational",
      "response_time_ms": 128,
      "last_check": "2026-06-23T09:14:02Z",
      "show_uptime": true,
      "show_response_time": true
    },
    {
      "id": 43,
      "name": "Website",
      "display_name": null,
      "group_name": "Core",
      "current_status": "down",
      "response_time_ms": null,
      "last_check": "2026-06-23T09:13:55Z",
      "show_uptime": true,
      "show_response_time": false
    }
  ],
  "incidents": [
    {
      "id": 9,
      "monitor_name": "Website",
      "title": "Elevated error rate",
      "status": "investigating",
      "severity": "major",
      "started_at": "2026-06-23T09:00:00Z"
    }
  ],
  "uptime_history": [
    { "date": "2026-06-22", "uptime": 100, "hasData": true },
    { "date": "2026-06-23", "uptime": 99.86, "hasData": true }
  ]
}

When any assigned monitor is down, overall_status becomes partial and that monitor's group is also reported as partial. Only active monitors (is_active = true) appear in the payload.

Errors

User API — Status Pages

These endpoints require a user API token. Generate one at Dashboard → Settings → API (/dashboard/settings/api) and send it as a Bearer token. Results are scoped to the status pages your account and team own. The User API is read-only for status pages; create and edit them from the dashboard.

Authorization: Bearer YOUR_API_TOKEN

List status pages

GET /v1/status-pages

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://api.statusradar.dev/v1/status-pages

Returns the status pages owned by your team, including both public and private pages, each with its slug, title, is_public, show_history_days, language, theme, and the count of assigned monitors.

Get a status page

GET /v1/status-pages/{id}

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://api.statusradar.dev/v1/status-pages/12

Returns a single status page by numeric id with its full configuration and assigned monitors. Returns 404 if the page does not exist or is not owned by your team.

Status Page Fields

These fields define a status page. They are set in the dashboard and surfaced by the endpoints above.

Per-monitor display settings

When you assign a monitor to a page, these per-assignment settings control how it appears:

Managing Status Pages (Dashboard)

Create and configure status pages from the dashboard — these actions are not exposed on the public/User API:

• Create — Dashboard → Status Pages → Create (/dashboard/status-pages/create). Set title, slug, description, visibility, language, history window, and theme.
• Edit — /dashboard/status-pages/{slug}/edit.
• Assign monitors — /dashboard/status-pages/{slug}/manage-monitors. Pick monitors and set per-monitor display options.
• Delete — removes the page and its monitor assignments.

Status page creation is subject to your plan's status-page quota; reaching the limit prompts an upgrade. See Status Pages.

Public Page URL

Every public status page is also viewable as an HTML page at:

https://statusradar.dev/status/{slug}

This is the human-facing version of the same data returned by GET /api/status/{slug} — share it with your users. Private pages return 404 at this URL.

Next Steps

• API Overview — the full API surface and base URLs
• API Authentication — token types and how to send them
• Status Pages — building and customizing status pages
• Monitors — create the monitors you assign to a page
• Alerts — alerting that surfaces as incidents on a page