APapaleo
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'.<br>For fine-grained clients, you must have this permission: 'core.maintenances.read'.

get/operations/v1/maintenances

Request

  • Base URL
    https://api.apaleo.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.apaleo.com/operations/v1/maintenances
  • Auth
    OAuth 2
    Implicit: https://identity.apaleo.com/connect/authorize
    Scopes: maintenances.read, maintenances.manage, admin

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-10-15T12:15:11.7947001+02:00",
      "to": "2026-10-17T12:15:11.7947001+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-10-19T14:15:11.7947001+02:00",
      "to": "2026-10-21T12:15:11.7947001+02:00",
      "type": "OutOfOrder",
      "description": "Wall tiles came down in the bathroom, needs some refurbishment."
    }
  ],
  "count": 0
}

Changes

No recorded changes to this operation across all 7 revisions of this API.