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

x-meeting-baas-api-key<token>

API key for authentication

In: header

Query Parameters

attendee_emailstring | null

If provided, filters events to include only those with this attendee's email address Example: "jane.smith@example.com"

calendar_idRequiredstring

Calendar ID to filter events by This is required to specify which calendar's events to retrieve

cursorstring | null

Optional cursor for pagination This value is included in the next field of the previous response

organizer_emailstring | null

If provided, filters events to include only those with this organizer's email address Example: "john.doe@example.com"

start_date_gtestring | null

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"

start_date_ltestring | null

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"

statusstring | null

Filter events by meeting status Valid values: "upcoming" (default) returns events after current time, "past" returns previous events, "all" returns both

updated_at_gtestring | null

If provided, fetches only events updated at or after this timestamp Format: ISO-8601 string, e.g., "2023-01-01T00:00:00Z"

curl -X GET "https://api.meetingbaas.com/calendar_events/?attendee_email=string&calendar_id=string&cursor=string&organizer_email=string&start_date_gte=string&start_date_lte=string&status=string&updated_at_gte=string" \
  -H "x-meeting-baas-api-key: <token>"

{
  "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",
        "waiting_room_timeout": 0,
        "webhook_url": "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"
}

Authorization

Query Parameters

Response

TypeScript