Maintenance

Get list of maintenances

Get a list of maintenances matching your filter.<br>You must have at least one of these scopes: 'maintenances.read, maintenances.manage'.

get/operations/v1/maintenances

Query parameters

propertyIdstring

Filter result by property id

unitIdstring

Filter result by unit id

fromstring date-time

Filter all maintenance windows that end after the specified date and time<br />A date and time (without fractional second part) in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>

tostring date-time

Filter all maintenance windows that start before the specified date and time<br />A date and time (without fractional second part) in UTC or with UTC offset as defined in <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO8601:2004</a>

typesstring[]

Filter result by maintenance types

pageNumberinteger

Page number to retrieve. Default: 1. If the page has no items, the API returns 204 No Content.

pageSizeinteger

Items per page. Default: 500. Maximum: 500.

expandstring[]

List of all embedded resources that should be expanded in the response. Possible values are: unit. All other values will be silently ignored.

Response

Return all maintenances.

countinteger required

Total count of items

Example response

{
  "maintenances": [
    {
      "id": "MUC-JQI-SGHZD",
      "unit": {
        "id": "MUC-JQI",
        "name": "A.102",
        "description": "Double room",
        "unitGroupId": "MUC-DBL"
      },
      "from": "2026-09-01T13:48:09.6809666+02:00",
      "to": "2026-09-03T13:48:09.6809666+02:00",
      "type": "OutOfService",
      "description": "The remote control for the TV needs to be replaced."
    },
    {
      "id": "MUC-MTA-GSZGK",
      "unit": {
        "id": "MUC-MTA",
        "name": "A.101",
        "description": "Single room",
        "unitGroupId": "MUC-SGL"
      },
      "from": "2026-09-05T15:48:09.6809666+02:00",
      "to": "2026-09-07T13:48:09.6809666+02:00",
      "type": "OutOfOrder",
      "description": "Wall tiles came down in the bathroom, needs some refurbishment."
    }
  ],
  "count": 0
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.