[role="xpack"]
[[ml-get-calendar]]
=== Get Calendars API
++++
<titleabbrev>Get Calendars</titleabbrev>
++++

The get calendars API enables you to retrieve configuration information for
calendars.


==== Request

`GET _xpack/ml/calendars/<calendar_id>` +

`GET _xpack/ml/calendars/<calendar_id>,<calendar_id>` +

`GET _xpack/ml/calendars/` +

`GET _xpack/ml/calendars/_all`


//===== Description

////
You can get information for multiple jobs in a single API request by using a
group name, a comma-separated list of jobs, or a wildcard expression. You can
get information for all jobs by using `_all`, by specifying `*` as the
`<job_id>`, or by omitting the `<job_id>`.
////

==== Path Parameters

`calendar_id`::
  (string) Identifier for the calendar. It can be a calendar identifier or a
  wildcard expression. If you do not specify one of these options, the API
  returns information for all calendars.


==== Request Body

`from`:::
    (integer) Skips the specified number of calendars.

`size`:::
    (integer) Specifies the maximum number of calendars to obtain.

//==== Results

////
The API returns the following information:

`jobs`::
  (array) An array of job resources.
  For more information, see <<ml-job-resource,Job Resources>>.
////

==== Authorization

You must have `monitor_ml`, `monitor`, `manage_ml`, or `manage` cluster
privileges to use this API. For more information, see
{xpack-ref}/security-privileges.html[Security Privileges].


//==== Examples
