API Reference

Interact with ApexUptime programmatically using our RESTful API.

Authentication

All API requests must include your Bearer token in the Authorization header. You can generate an API key in your Dashboard Settings.

Authorization: Bearer pw_live_xxxxxxxxxxxxx

Core Endpoints

GET/v1/monitors

Returns a paginated list of all your configured monitors, their current status, and 24h uptime percentage.

POST/v1/monitors

Create a new monitor. Requires a JSON body.

{
  "name": "Production API",
  "url": "https://api.example.com/health",
  "type": "http",
  "interval": 30,
  "keyword": "OK"
}
PUT/v1/monitors/:id/pause

Pause a monitor (trigger a maintenance window). It will not trigger alerts until resumed.

DELETE/v1/monitors/:id

Permanently delete a monitor and its historical data.

Incidents & Webhooks

GET/v1/incidents

Retrieve a history of all downtime incidents across your account. Filter by date range or monitor ID.

POST/v1/webhooks

Register a new custom webhook URL to receive instant push notifications when a monitor goes DOWN or UP.