Try it free

List business calendars

  • Latest Dynatrace
  • Reference
  • Published Oct 13, 2026

List business calendars in Dynatrace with the Automation API, using search, ordering, offset, and limit to page and filter results.

GETSaaShttps://{your-environment-id}.apps.dynatrace.com/platform/automation/v1/business-calendars

Overview

You can use limit, offset, ordering, and search to page, sort, and filter the business calendars returned. Dynatrace returns a list of business calendars from the Automation API.

Authentication

To execute this request, you need a platform token or OAuth access token with automation:calendars:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
limitinteger

Number of results to return per page.

queryOptional
offsetinteger

The initial index from which to return the results.

queryOptional
orderingstring

Which field to use when ordering the results.

queryOptional
searchstring

A search term.

queryOptional

Response

Response codes

CodeTypeDescription
200PaginatedBusinessCalendarResponseList-
4XXErrorEnvelope-

Response body objects

The PaginatedBusinessCalendarResponseList object

ElementTypeDescription
countinteger-
resultsBusinessCalendarResponse[]-

The BusinessCalendarResponse object

ElementTypeDescription
idstring-
titlestring-
versioninteger-
weekstartinteger-
holidaysHoliday[]-
validFromstring-
validTostring-
descriptionstring-
modificationInfoModificationInfo-
weekdaysWeekdaysValues

The weekdays values

weekdaysNamesWeekdaysNames

The weekdays names

The Holidays object

The Holiday object

ElementTypeDescription
titlestring-
datestring-

The ModificationInfo object

ElementTypeDescription
createdBystring-
createdTimestring-
lastModifiedBystring-
lastModifiedTimestring-

The WeekdaysValues object

The WeekdaysNames object

The ErrorEnvelope object

ElementTypeDescription
errorError-

The Error object

ElementTypeDescription
messagestring-
codeinteger-
detailsErrorDetails-

The ErrorDetails object

ElementTypeDescription
errorCodestring-
errorRefstring-

Response body JSON models

{
  "count": 123,
  "results": [
    {
      "id": "string",
      "title": "string",
      "version": 1,
      "weekstart": 1,
      "holidays": [
        {
          "title": "string",
          "date": "string"
        }
      ],
      "validFrom": "string",
      "validTo": "string",
      "description": "string",
      "modificationInfo": {
        "createdBy": "string",
        "createdTime": "string",
        "lastModifiedBy": "string",
        "lastModifiedTime": "string"
      },
      "weekdays": [
        1,
        2,
        3,
        4,
        5
      ],
      "weekdaysNames": [
        "MO",
        "TU",
        "WE",
        "TH",
        "FR"
      ]
    }
  ]
}
{
  "error": {
    "message": "string",
    "code": 1,
    "details": {
      "errorCode": "string",
      "errorRef": "string"
    }
  }
}
Related tags
Platform APIDynatrace Platform