---
title: "List Calendar Events"
method: GET
path: "/calendar/events"
tags: ["Calendar"]
---

# List Calendar Events

`GET /calendar/events`

List calendar events for current user.

## Query parameters

- `start` string, nullable — Start time for filtering events (ISO format)
- `end` string, nullable — End time for filtering events (ISO format)
- `limit` integer — Maximum number of events to return
- `offset` integer — Number of events to skip
- `order_by` 'start_time_asc' | 'start_time_desc' | 'end_time_asc' | 'end_time_desc' — Order by for calendar events.
- `conference_provider` 'zoom' | 'teams' | 'meet' | 'other' | 'none' — Conference provider types.
- `recording_skipped` boolean, nullable — Filter by recording skipped
- `recording_skipped_reason` 'bot_failed_to_join' | 'bot_was_disabled' | 'event_was_deleted' — Reason why a call recording was skipped.
- `filter_physical_events` boolean, nullable — Filter physical events
- `deleted` boolean, nullable — Filter by deleted

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- CalendarEventListResult — Response with list of calendar events.
  - `events` CalendarEventResult[], required — List of calendar events
    - `id` string, uuid, required — Event ID
    - `subject` string, required — Event subject
    - `start_time` string, date-time, required — Event start time
    - `end_time` string, date-time, required — Event end time
    - `description` string, nullable — Event description
    - `location` string, nullable — Event location
    - `conference_url` string, nullable — Conference URL
    - `conference_provider` 'zoom' | 'teams' | 'meet' | 'other' | 'none' — Conference provider types.
    - `language` string, nullable — Language of the event
    - `attendees` object[] — List of attendees
    - `intelligence` CallIntelligenceResult — DTO for call intelligence.
      - `call_objective` string, nullable — Call objective
      - `call_goal` 'DISCOVERY' | 'DEMO' | 'NEGOTIATION' | 'CLOSING' | 'QBR' | 'SUPPORT' | 'ONBOARDING' | 'INTERNAL' | 'VC' | 'PRODUCT_RESEARCH' | 'OTHER' — Call goal types.
      - `goal_confidence_score` number, nullable — Confidence score for goal classification
      - `derived_from` 'AI_ANALYSIS' | 'USER_INPUT' | 'KEYWORD_MATCH' | 'UNKNOWN', required — Intelligence source types.
      - `created_at` string, date-time, required — Creation timestamp
      - `updated_at` string, date-time, required — Last update timestamp
    - `call` CallResult
      - `call_id` string, uuid, required
      - `start_time` string, date-time, required
      - `end_time` string, date-time, nullable, required
      - `thumbnail` string, nullable, required
      - `recording` string, nullable, required
      - `duration` integer, nullable, required
      - `transcript` TranscriptCaption[], nullable, required
        - `speaker_name` string, required
        - `caption` string, required
        - `language` string, nullable, required
        - `start_time` number, nullable, required
        - `end_time` number, nullable, required
      - `title` string, nullable, required
      - `description` string, nullable, required
      - `summary` string, nullable, required
      - `coaching_summary` string, nullable, required
      - `language` string, nullable, required
    - `recall_bot_enabled` boolean, required — Whether the Recall bot is enabled for the event
  - `total` integer, required — Total number of events

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/nomi/apis/fastapi.md) · [All operations](https://skmtc.dev/nomi/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nomi/fastapi/revisions/63a2f545499c/schema)