Calendar

Get Calendar Events By Date

Get calendar events from the database for a given date range.

calendar_id: The ID of the calendar to fetch events from (path parameter)
date: The start date (ISO format, e.g., '2025-10-06'). Defaults to today if not provided.
Returns events from the start of this date (00:00:00) to 2 months later

Note: Events must be refreshed using POST /calendars/{calendar_id}/refresh to be available.

get/calendars/{calendar_id}/events

Path parameters

calendar_idstring uuid required

Query parameters

datestring date nullable

The start date (events will be fetched from beginning of this date to 2 months later). Defaults to today.

Response

Successful Response

idstring nullable

titlestring required

descriptionstring nullable

start_timestring date-time required

end_timestring date-time required

all_dayboolean

start_datestring date nullable

end_datestring date nullable

locationstring nullable

attendeesstring[] nullable

organizerstring nullable

statusstring nullable

Example response

[
  {
    "all_day": false,
    "attendees": [
      "john.doe@example.com"
    ],
    "description": "Initial consultation with John Doe",
    "end_time": "2025-10-15T15:00:00Z",
    "location": "Law Office - Room 201",
    "start_time": "2025-10-15T14:00:00Z",
    "title": "Client Consultation"
  }
]

Changes

No recorded changes to this endpoint across all 2 revisions of this API.