StatusPage.me Help Center

Popular topics: creating a status page, connecting monitors, automatic incidents, custom domains, integrations and billing.

StatusPage.me Mar 14, 2026 API

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.

ScopeDescription
monitors:readRead monitor list and availability data
incidents:readRead incidents and updates
incidents:writeCreate, update, delete incidents and post updates
maintenances:readRead maintenance windows
maintenances:writeCreate, update, delete maintenance windows
status-pages:readRead status page list and details
analytics:readRead availability/uptime metrics

Response Format

All endpoints return JSON. Successful responses use this envelope:

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

Errors return:

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

HTTP Status Codes

CodeMeaning
200OK
201Created
400Bad request (validation error)
401Unauthorized — missing or invalid API key
403Forbidden — API key lacks required scope
404Not found or access denied
500Internal server error

Rate Limiting

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


Available Resources

ResourceArticle
Monitors & availabilityMonitors API
Incidents (CRUD)Incidents API
Maintenances (CRUD)Maintenances API

Managing API Keys

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

Was this article helpful?

Share this article: