List and retrieve calendar events synced from connected calendar providers.
Retrieve a paginated list of calendar events for the authenticated user. Events are synced from connected calendar providers (Google Calendar, Outlook Calendar, Zoom, Apple Calendar). Results can be filtered by time range, provider, and auto-join status.
skip integer optional · Defaults to 0
Number of items to skip for pagination (minimum: 0).
limit integer optional · Defaults to 50
Maximum number of items to return (minimum: 1, maximum: 100).
start_after string optional
Filter events starting after this datetime. ISO 8601 format (e.g., 2026-01-01T00:00:00Z).
start_before string optional
Filter events starting before this datetime. ISO 8601 format (e.g., 2026-12-31T23:59:59Z).
provider string optional
Filter by calendar provider. Valid values: google_calendar, outlook_calendar, zoom, apple_calendar.
auto_join_status string optional
Filter by auto-join status. Valid values: pending, scheduled, joined, skipped, failed.
Returns a paginated list of calendar event objects with total count and has_more indicator.
| Field | Type | Description |
|---|---|---|
id | string | Unique event ID (mcevt_ prefix) |
calendar_provider | string | Calendar provider name |
title | string | Event title |
start_time | string | Event start time (ISO 8601) |
end_time | string | Event end time (ISO 8601) |
timezone | string | Event timezone |
meeting_link | string or null | Extracted meeting link (Zoom, Meet, Teams) |
meeting_platform | string or null | Detected platform (zoom, google_meet, teams) |
organizer_email | string or null | Event organizer email |
attendee_count | integer | Number of attendees |
is_recurring | boolean | Whether the event is recurring |
status | string | Event status (confirmed, tentative, cancelled) |
auto_join_status | string | Auto-join status |
session_id | string or null | Linked Meeting Buddy session ID |
synced_at | string | Last sync time (ISO 8601) |
created_at | string | Record creation time (ISO 8601) |
- Bash
- Python
- Python
- JavaScript
curl -s -X GET "https://api.aitronos.com/v1/meeting-buddy/calendar/events?limit=20&provider=google_calendar" \
-H "Authorization: Bearer $ACCESS_TOKEN" | python3 -m json.toolRetrieve details for a specific calendar event by its ID.
event_id string required
The calendar event ID (mcevt_ prefix).
Returns a single Calendar Event object.
- Bash
- Python
- Python
- JavaScript
curl -s -X GET "https://api.aitronos.com/v1/meeting-buddy/calendar/events/mcevt_abc123def456" \
-H "Authorization: Bearer $ACCESS_TOKEN" | python3 -m json.tool