> ## 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.

# List calendar events

> Returns calendar events in your Plane workspace.

Use this endpoint when you need scheduled items for calendar or schedule sync use cases.
Results are returned in chronological order, sorted by `starts` and then by `id`.

### Parameters

<ParamField query="calendar" type="string">
  Only return events for this calendar ID.
</ParamField>

<ParamField query="starts" type="string">
  Only return events whose end date falls on or after this date. Use an ISO 8601 date such as
  `2026-04-01`.
</ParamField>

<ParamField query="ends" type="string">
  Only return events whose start date falls on or before this date. Use an ISO 8601 date such as
  `2026-04-30`.
</ParamField>

<ParamField query="limit" type="number">
  A limit on the number of objects to be returned. Limit can range between 1 and 100, and the
  default is 10.
</ParamField>

<ParamField query="cursor" type="string">
  A value from a previous response that lets you fetch the next page.
</ParamField>

<ParamField query="starting_after" type="string">
  Return results after this calendar event ID.
</ParamField>

<ParamField query="ending_before" type="string">
  Return results before this calendar event ID.
</ParamField>

If you send `starts` or `ends`, Plane returns an event when any part of it falls inside that date
window.

### Returns

Returns a dictionary with a `calendar_events` property that contains an array of
[Calendar event](/reference/calendar-events/object) objects. If no matching events exist, the array
is empty.

<ResponseExample>
  ```json Response theme={null}
  {
    "calendar_events": [
      {
        "id": "cale_K2mP9qR4xL7s",
        "object": "calendar.event",
        "calendar": "cal_cNqYX2J3s9bI2Aa",
        "title": "All Hands Meeting",
        "description": "Monthly company-wide meeting",
        "starts": "2026-04-14T10:00:00Z",
        "ends": "2026-04-14T11:00:00Z",
        "all_day": false,
        "subject": "ent_airfoil",
        "metadata": {},
        "created": "2026-03-10T18:42:11Z",
        "updated": "2026-03-11T09:05:52Z"
      }
    ]
  }
  ```
</ResponseExample>