Events

List user events

Returns events from the user's active calendars.

Filtering:

  • calendar_id: Filter to a specific calendar (cal_xxx format)
  • start_date: Events ending after this date (YYYY-MM-DD)
  • end_date: Events starting before this date (YYYY-MM-DD)

Expand parameter: By default, description, location, attendees, html_link, event_link, visibility, and response_status are not included. Use expand=description,location,attendees,html_link,event_link,visibility,response_status to include these fields.

Pagination (cursor-only):

  • limit: Maximum number of events per page (default: 100, max: 500)
  • cursor: Opaque token from pagination.next_cursor of a prior response. Pass it back unchanged to fetch the next page. Omit on the first page.

Ordering: start_time ASC — earliest event first.

Note: Only events from active calendars are returned. Cancelled events are excluded.

get/v1/users/{user_id}/events

Request

  • Base URL: http://0.0.0.0:3000
  • URL: http://0.0.0.0:3000/v1/users/{user_id}/events
  • Auth: none declared

Path parameters

user_idstring uuid required

Query parameters

calendar_idstring

Filter to a specific calendar (cal_xxx format)

start_datestring date

Events ending after this date (YYYY-MM-DD format)

end_datestring date

Events starting before this date (YYYY-MM-DD format)

limitstring

Number of items to return (1-100, default 50)

cursorstring

Opaque pagination cursor returned as pagination.next_cursor from a prior response. Pass it back unchanged to fetch the next page. Cursors are sort-key bound — a cursor from one endpoint cannot be reused on another.

expandstring

Comma-separated list of fields to include. Valid options: description, location, attendees, html_link, event_link, visibility, response_status

Response

Default Response

successtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.