CorefinityCorefinityDocs
Open the Control PanelControl Panel
Maintenance windows · 14 of 14

List upcoming maintenance windows

Answers the next seven days of windows with what is queued for each: for one site (site), for the sites of one CoreCluster (cluster), or for every site you can see, up to 200.

GET/api/maintenance-windows/upcoming

Query parameters

siteinteger

The id of one site row. At least 1.

clusterinteger

The id of one CoreCluster. Read only when site is not sent. At least 1.

Returns

200 The days that have a window, soonest first.

Fields of the 200 answer
daysarray of objectsRequired
Fields of each item
local_datestringRequired
slotsarray of objectsRequired
Fields of each item
domainstringRequired
ends_atstringRequired

Format: date-time.

environmentobject or any or nullRequired
labelstringRequired
pendingarray of objectsRequired

What is queued for this occurrence.

Fields of each item
kind_labelstringRequired
ownbooleanRequired

True for a change you made yourself.

site_idintegerRequired

At least 1.

starts_atstringRequired

Format: date-time.

If it is refused

StatusReasonWhat to do
401noneSend a valid token as Authorization: Bearer <token>.
403scope_requiredUse a token with the scope named in scope.
404feature_offThis feature is not on for your organisation yet.
429rate_limitedWait for the seconds in Retry-After.

Reasons are listed by name in Errors and refusals.

The same task elsewhere

curl https://manage.corefinity.com/api/maintenance-windows/upcoming \
  -H "Authorization: Bearer $COREFINITY_TOKEN" \
  -H "Accept: application/json"
{
  "days": [
    {
      "local_date": "2026-11-04",
      "slots": [
        {
          "domain": "harbourandfinch.example.com",
          "ends_at": "2026-11-04T04:00:00Z",
          "environment": null,
          "label": "00:00–04:00 UK time",
          "pending": [],
          "site_id": 1042,
          "starts_at": "2026-11-04T00:00:00Z"
        }
      ]
    }
  ]
}
Try it
Held in this tab's memory only. Never stored or sent to us.

Use a token with only the read scope. How to make one

Was this helpful?
Open in ClaudeOpen in ChatGPT