List Events
Retrieves a paginated list of calendar events with comprehensive filtering options. Supports filtering by organizer email, attendee email, date ranges (start_date_gte, start_date_lte), and event status. Results can be limited to upcoming events (default), past events, or all events. Each event includes full details such as meeting links, participants, and recording status. The response includes a 'next' pagination cursor for retrieving additional results.
Authorization
ApiKeyAuth API key for authentication
In: header
Query Parameters
If provided, filters events to include only those with this attendee's email address Example: "jane.smith@example.com"
Calendar ID to filter events by This is required to specify which calendar's events to retrieve
Optional cursor for pagination This value is included in the next field of the previous response
If provided, filters events to include only those with this organizer's email address Example: "john.doe@example.com"
If provided, filters events to include only those with a start date greater than or equal to this timestamp Format: ISO-8601 string, e.g., "2023-01-01T00:00:00Z"
If provided, filters events to include only those with a start date less than or equal to this timestamp Format: ISO-8601 string, e.g., "2023-12-31T23:59:59Z"
Filter events by meeting status Valid values: "upcoming" (default) returns events after current time, "past" returns previous events, "all" returns both
If provided, fetches only events updated at or after this timestamp Format: ISO-8601 string, e.g., "2023-01-01T00:00:00Z"
Response Body
application/json
curl -X GET "https://api.meetingbaas.com/calendar_events/?calendar_id=string"{
"data": [
{
"attendees": [
{
"email": "string",
"name": "string"
}
],
"bot_param": {
"bot_image": "string",
"bot_name": "string",
"deduplication_key": "string",
"enter_message": "string",
"extra": {},
"noone_joined_timeout": 0,
"recording_mode": "speaker_view",
"speech_to_text_api_key": "string",
"speech_to_text_provider": "Gladia",
"streaming_audio_frequency": "16khz",
"streaming_input": "string",
"streaming_output": "string",
"transcription_custom_parameters": {},
"waiting_room_timeout": 0,
"webhook_url": "string",
"zoom_access_token_url": "string",
"zoom_obf_token": "string",
"zoom_obf_token_url": "string",
"zoom_obf_token_user_id": "string",
"zoom_sdk_id": "string",
"zoom_sdk_pwd": "string"
},
"calendar_uuid": "fd186a18-ef28-468e-9173-223796807e2e",
"deleted": true,
"end_time": "2019-08-24T14:15:22Z",
"google_id": "string",
"is_organizer": true,
"is_recurring": true,
"last_updated_at": "2019-08-24T14:15:22Z",
"meeting_url": "string",
"name": "string",
"raw": {},
"recurring_event_id": "string",
"start_time": "2019-08-24T14:15:22Z",
"uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
}
],
"next": "string"
}