> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plane.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a calendar

> Retrieve an existing calendar.

Retrieve a single [Calendar](/reference/calendars/object) by its ID.

### Parameters

<ParamField path="id" type="string" initialValue="cal_cNqYX2J3s9bI2Aa" required>
  The ID of the calendar to retrieve.
</ParamField>

### Returns

Returns the [Calendar](/reference/calendars/object) object if a valid ID was provided. Otherwise,
returns an error.

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "cal_cNqYX2J3s9bI2Aa",
    "object": "calendar",
    "name": "Company Events",
    "description": "Company-wide events and meetings",
    "purpose": [ "holidays" ],
    "metadata": {},
    "created": "2024-01-15T00:00:00Z",
    "updated": "2024-02-01T00:00:00Z"
  }
  ```
</ResponseExample>