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_xxxxxxxxxxxxxCore Endpoints
GET
/v1/monitorsReturns a paginated list of all your configured monitors, their current status, and 24h uptime percentage.
POST
/v1/monitorsCreate 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/pausePause a monitor (trigger a maintenance window). It will not trigger alerts until resumed.
DELETE
/v1/monitors/:idPermanently delete a monitor and its historical data.
Incidents & Webhooks
GET
/v1/incidentsRetrieve a history of all downtime incidents across your account. Filter by date range or monitor ID.
POST
/v1/webhooksRegister a new custom webhook URL to receive instant push notifications when a monitor goes DOWN or UP.