---
title: "POST /api/maintenance-windows/preview-occurrences"
method: POST
path: "/api/maintenance-windows/preview-occurrences"
tags: ["Maintenance Windows"]
---

# POST /api/maintenance-windows/preview-occurrences

`POST /api/maintenance-windows/preview-occurrences`

## Request

- Base URL: `https://uptimeify.io`
- URL: `https://uptimeify.io/api/maintenance-windows/preview-occurrences`
- Auth: HTTP bearer

## Request body

- object
  - `startTime` union, required
    - string
    - number
  - `endTime` union, required
    - string
    - number
  - `isRecurring` boolean, required
  - `recurrencePattern` object, nullable
    - `frequency` 'daily' | 'weekly' | 'monthly', required
    - `interval` integer
    - `daysOfWeek` integer[]
    - `dayOfMonth` integer
    - `endRecurrenceDate` string
  - `timezone` string

## Response `200`

Successful response

- object
  - `occurrences` object[], required: The next occurrences within five years.
    - `start` string, date-time, required
    - `end` string, date-time, required

## Other responses

- `400`: Invalid or missing parameters.
- `401`: Missing, invalid or expired API token.
- `500`: Unexpected server error.

---

[API](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api.md) · [All operations](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/uptimeify/apis/uptimeify-rest-api/revisions/2129a771ee7e?raw)