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

# List Calendar Events

`GET /calendar/events`

## Request

- Base URL: `https://api.nomi.so` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nomi.so/calendar/events`
- Auth: none declared

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/nomi-api.md) - [All operations](https://skmtc.dev/nomi/apis/nomi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nomi/apis/nomi-api/revisions/63a2f545499c?raw)