Copy page

Status pages

Status page JSON API

Every Spectate status page serves its status as JSON in the Atlassian Statuspage v2 format. Tools that read Statuspage pages, such as status aggregators, chat bots and dashboards, can read a Spectate page without changes. The API is read-only, needs no token for public pages, and any website can call it.

Endpoints

All endpoints are on the domain of the page: the default address https://<slug>.spectate.page, or the custom domain.

The Overview tab of the status page in the dashboard shows the summary.json URL of the page.

Example

Code
curl https://acme.spectate.page/api/v2/status.json

Code
{
  "page": {
    "id": "9b2f6d1e-4c3a-4f7e-8a51-2d0c9e7b6a14",
    "name": "Acme Cloud",
    "url": "https://acme.spectate.page",
    "time_zone": "Etc/UTC",
    "updated_at": "2026-10-27T09:41:12Z"
  },
  "status": {
    "indicator": "major",
    "description": "Partial System Outage"
  }
}

summary.json returns page, components, incidents, scheduled_maintenances and status:

Code
{
  "page": { "id": "9b2f6d1e-...", "name": "Acme Cloud", "url": "https://acme.spectate.page", "time_zone": "Etc/UTC", "updated_at": "2026-10-27T09:41:12Z" },
  "components": [
    {
      "id": "5e0c2a77-...",
      "name": "Core services",
      "status": "partial_outage",
      "created_at": "2026-03-02T10:00:00Z",
      "updated_at": "2026-10-27T09:12:00Z",
      "position": 1,
      "description": null,
      "showcase": false,
      "start_date": null,
      "group_id": null,
      "page_id": "9b2f6d1e-...",
      "group": true,
      "only_show_if_degraded": false,
      "components": ["c41d8e02-..."]
    },
    {
      "id": "c41d8e02-...",
      "name": "API",
      "status": "partial_outage",
      "created_at": "2026-03-02T10:00:00Z",
      "updated_at": "2026-10-27T09:12:00Z",
      "position": 2,
      "description": "Public REST API",
      "showcase": true,
      "start_date": "2026-03-02",
      "group_id": "5e0c2a77-...",
      "page_id": "9b2f6d1e-...",
      "group": false,
      "only_show_if_degraded": false
    }
  ],
  "incidents": [
    {
      "id": "0f7a3b9c-...",
      "name": "Elevated API error rates",
      "status": "identified",
      "created_at": "2026-10-27T09:14:30Z",
      "updated_at": "2026-10-27T09:41:12Z",
      "monitoring_at": null,
      "resolved_at": null,
      "impact": "major",
      "shortlink": "https://acme.spectate.page/incidents/0f7a3b9c-...",
      "started_at": "2026-10-27T09:12:00Z",
      "page_id": "9b2f6d1e-...",
      "incident_updates": [
        {
          "id": "a83e5d10-...",
          "status": "identified",
          "body": "We found the cause and are applying a fix.",
          "incident_id": "0f7a3b9c-...",
          "created_at": "2026-10-27T09:41:12Z",
          "updated_at": "2026-10-27T09:41:12Z",
          "display_at": "2026-10-27T09:41:12Z"
        }
      ],
      "components": [{ "id": "c41d8e02-...", "name": "API", "status": "partial_outage" }]
    }
  ],
  "scheduled_maintenances": [],
  "status": { "indicator": "major", "description": "Partial System Outage" }
}

The example shortens IDs and the components of the incident. The API returns full UUIDs and full component objects.

Fields

Overall status

Components

A component's status is operational, degraded_performance, partial_outage, major_outage or under_maintenance. See component statuses.

A group is a component with group: true. Its components field lists the IDs of its components. Each component in a group has the group's ID in group_id. The status of a group is the worst status of its components.

Incidents

Scheduled maintenances

Maintenances have the same fields as incidents, and also these:

Private pages

A private page returns 404 without access. Add the access key of the page to the URL:

Code
curl "https://acme.spectate.page/api/v2/summary.json?key=YOUR_ACCESS_KEY"

Responses of a private page have Cache-Control: private, no-store. Anyone with the key can read the page, so keep the key out of public code.

Caching and errors

Spectate builds the data of a page at most once per 30 seconds. Public responses have Cache-Control: public, max-age=30. A change can take up to 30 seconds to show in the API.

CORS

Every response has Access-Control-Allow-Origin: *, so a script on any website can read the API. OPTIONS requests return 204 with Access-Control-Allow-Methods: GET, OPTIONS.

Differences from Atlassian Statuspage

• time_zone is always Etc/UTC. All times are UTC, in the format 2026-10-27T09:41:12Z.
• Spectate calculates group IDs from the page and the group name. If you rename a group, its ID changes.
• showcase is true for components and false for groups. only_show_if_degraded is always false. start_date is the date that the component was created.
• Incidents never have the status postmortem. Maintenances never have the status verifying.
• A maintenance has no separate updates. Its description is its only update.
• If you hide incidents or maintenance in Settings → Display, incidents or scheduled_maintenances is an empty list.
• The API is read-only. It has no endpoints for subscribers or for changes. To change a status page, use the public API of Spectate.

Related

• RSS and Atom feeds
• Status pages in the API reference