Authenticated REST API

The StatusPage.me authenticated API lets you read and write your status page data from your own applications, CI pipelines, on-call tools, and monitoring integrations.

Availability

API access is available on the Pro, Growth, Business, and Enterprise plans. Upgrade your plan if needed.

Base URL

https://statuspage.me/user/api/v1

Authentication

Generate an API key from the API Console. Then include it in every request using one of:

Authorization: Bearer spk_...

or

X-API-Key: spk_...

Tokens start with spk_ and are shown only once at creation. Store them securely.

Scopes

When creating a key you can restrict it to specific scopes. An empty scope list means full access.

Response Format

All endpoints return JSON. Successful responses use this envelope:

{
  "data": { ... },
  "meta": { "count": 5 }
}

Errors return:

{
  "error": "human-readable message"
}

HTTP Status Codes

Safe retries for creates

The create endpoints for status pages, monitors, incidents, maintenances, and metrics support an optional Idempotency-Key header. Send a unique key for each logical create operation so a retry after a timeout returns the original successful response instead of creating a duplicate.

Idempotency-Key: deploy-2026-07-22-001

Reuse the key only with the exact same request body. Reusing it with a different body returns 409 Conflict. Keys may be up to 255 characters long.

Rate Limiting

API requests are subject to the same rate limits as other requests. If you need higher limits, contact support.

Available Resources

Managing API Keys

Visit the API Console to create, view usage logs, and revoke your API keys.

See also: API Keys