Uptimeify Docs
Website configuration

Check Maintenance (Batch)

Batch-check multiple websites for active maintenance windows.

POST /api/maintenance-windows/check/batch

This endpoint requires authentication via browser session or API token.

Request Body

{ "websiteIds": [101, "cd11a84d-96a2-41aa-a957-b1db8ee01b72", 103] }

Fields

  • websiteIds ((number|string)[], required): numeric website IDs or websitePublicId UUIDs

Example (cURL)

BASE_URL="https://uptimeify.io"
API_TOKEN="wsm_your_real_api_token"

curl -X POST "$BASE_URL/api/maintenance-windows/check/batch" \
  -H "Authorization: Bearer $API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"websiteIds":[101,"cd11a84d-96a2-41aa-a957-b1db8ee01b72",103]}'

Example Response

{
  "results": {
    "101": {
      "inMaintenance": true,
      "activeWindows": [
        {
          "id": 5,
          "name": "Weekly maintenance",
          "startTime": "2026-02-25T02:00:00.000Z",
          "endTime": "2026-02-25T04:00:00.000Z",
          "description": "Planned downtime"
        }
      ]
    },
    "cd11a84d-96a2-41aa-a957-b1db8ee01b72": { "inMaintenance": false, "activeWindows": [] }
  }
}

Common errors

  • 400 websiteIds array required when websiteIds is missing/empty
  • 400 All websiteIds must be valid identifiers when any entry is neither a positive integer ID nor a UUID
  • 401 Unauthorized when no valid session or API token is sent
  • 403 Forbidden when at least one website is outside the allowed customer/organization scope
  • 404 Website not found when a provided websitePublicId does not resolve to a website

On this page