Get a maintenance occurrence Beta
GET /api/v1/maintenance/occurrences/{id}
Needs an X-API-Key header whose owner has access to uptime monitoring in the app. The call counts once against your daily quota. See Monitoring API: getting started for authentication, rate limits and errors.
200 · application/json
- {
- "occurrence": { "id": "48213", "maintenanceId": "mw_3f9a0c1d2e4b5a6c7d8e", "description": "Weekly database backup",
- "from": "2026-09-20T02:00:00.000Z", "to": "2026-09-20T03:00:00.000Z", "modified": false },
- "usage": { "used": 37, "dailyLimit": 100, "tier": "free" }
- }
Errors
| Status | When |
|---|---|
401 | The API key is missing or invalid. |
403 | The key's owner doesn't have access to uptime monitoring, or the key isn't linked to a workspace. |
404 | No occurrence with that id in your workspace, or it has been cancelled. |
405 | The endpoint doesn't accept that method. |
429 | A rate limit or your daily quota was hit. Read Retry-After, in seconds. |
500 | Something went wrong on our side. Try again. |
503 | The API is temporarily unavailable. Try again shortly. |
Errors are JSON: { "error": "message" }. See Monitoring API errors.
Related
- Maintenance windows: how maintenance works and the window object
- List occurrences: find its id
- Move an occurrence: change it