Skip to main content
GET
/
v1
/
calendar
/
events
curl -G https://api.mavioapp.com/v1/calendar/events \
  -H "Authorization: Bearer mvo_live_abc123" \
  -d from=2026-04-14T00:00:00Z \
  -d to=2026-04-21T00:00:00Z \
  -d recording_status=scheduled

{
  "data": [
    {
      "id": "evt_g1c2a3l4",
      "title": "Weekly Product Sync",
      "start_time": "2026-04-15T14:00:00Z",
      "end_time": "2026-04-15T14:45:00Z",
      "provider": "google",
      "meeting_platform": "google_meet",
      "meeting_url": "https://meet.google.com/abc-defg-hij",
      "recording_status": "scheduled",
      "meeting_id": null,
      "attendees": ["alice@example.com", "bob@example.com", "carol@example.com"]
    }
  ],
  "pagination": {
    "total": 12,
    "limit": 20,
    "offset": 0,
    "has_more": false
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.mavioapp.com/llms.txt

Use this file to discover all available pages before exploring further.

Returns a list of calendar events from connected calendars, including whether each event has been or will be recorded by Mavio.
​
from
string
Return events starting on or after this date. ISO 8601 format. Defaults to the start of today.
​
to
string
Return events starting on or before this date. ISO 8601 format. Defaults to 7 days from now.
​
provider
string
Filter by calendar provider. One of google or outlook.
​
recording_status
string
Filter by recording status. One of scheduled, recording, completed, skipped.
​
limit
integer
default:"20"
Number of events to return. Between 1 and 100.
​
offset
integer
default:"0"
Number of events to skip for pagination.

​
Response

​
data
array
An array of calendar event objects.
curl -G https://api.mavioapp.com/v1/calendar/events \
  -H "Authorization: Bearer mvo_live_abc123" \
  -d from=2026-04-14T00:00:00Z \
  -d to=2026-04-21T00:00:00Z \
  -d recording_status=scheduled

{
  "data": [
    {
      "id": "evt_g1c2a3l4",
      "title": "Weekly Product Sync",
      "start_time": "2026-04-15T14:00:00Z",
      "end_time": "2026-04-15T14:45:00Z",
      "provider": "google",
      "meeting_platform": "google_meet",
      "meeting_url": "https://meet.google.com/abc-defg-hij",
      "recording_status": "scheduled",
      "meeting_id": null,
      "attendees": ["alice@example.com", "bob@example.com", "carol@example.com"]
    }
  ],
  "pagination": {
    "total": 12,
    "limit": 20,
    "offset": 0,
    "has_more": false
  }
}