> ## 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.

# Calendar sync status

> Get the sync status of connected calendars.

Returns information about connected calendar integrations, including sync status, last sync time, and any errors.

### Response

<ResponseField name="calendars" type="array">
  Array of connected calendar objects.

  <Expandable title="Calendar object">
    <ResponseField name="id" type="string">
      Calendar connection identifier.
    </ResponseField>

    <ResponseField name="provider" type="string">
      Calendar provider: `google` or `outlook`.
    </ResponseField>

    <ResponseField name="email" type="string">
      The email address associated with this calendar.
    </ResponseField>

    <ResponseField name="status" type="string">
      Connection status: `active`, `syncing`, `error`, or `disconnected`.
    </ResponseField>

    <ResponseField name="last_sync" type="string | null">
      ISO 8601 timestamp of the last successful sync.
    </ResponseField>

    <ResponseField name="next_sync" type="string | null">
      ISO 8601 timestamp of the next scheduled sync.
    </ResponseField>

    <ResponseField name="error" type="string | null">
      Error message if status is `error`. `null` otherwise.
    </ResponseField>

    <ResponseField name="events_synced" type="integer">
      Total number of events synced from this calendar.
    </ResponseField>

    <ResponseField name="auto_record" type="boolean">
      Whether auto-recording is enabled for this calendar.
    </ResponseField>

    <ResponseField name="connected_at" type="string">
      ISO 8601 timestamp when this calendar was connected.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.mavioapp.com/v1/calendar/sync \
    -H "Authorization: Bearer mvo_live_abc123"
  ```

  ```python Python theme={null}
  sync = client.calendar.sync_status()
  ```

  ```javascript Node.js theme={null}
  const sync = await client.calendar.syncStatus();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "calendars": [
      {
        "id": "cal_a1b2c3d4",
        "provider": "google",
        "email": "alice@example.com",
        "status": "active",
        "last_sync": "2026-04-14T09:45:00Z",
        "next_sync": "2026-04-14T10:00:00Z",
        "error": null,
        "events_synced": 342,
        "auto_record": true,
        "connected_at": "2026-02-10T08:30:00Z"
      }
    ]
  }
  ```
</ResponseExample>