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

# List Calendar Events

`GET /v2/calendar/events`

## Request

- Base URL: `https://api.mem.ai`
- URL: `https://api.mem.ai/v2/calendar/events`
- Auth: HTTP bearer

## Query parameters

- `start_time` string, date-time, nullable: Filter events ending at or after this time.
- `end_time` string, date-time, nullable: Filter events starting at or before this time.
- `calendar_id` string, nullable: Filter by external calendar ID (provider calendar ID).
- `limit` integer, nullable: Maximum number of events to return.

## Response `200`

OK

- ListCalendarEventsResponseSchema
  - `events` CalendarEventItemSchema[], required
    - `calendar_background_color` string, nullable
    - `calendar_id` string, nullable
    - `calendar_name` string, nullable
    - `end_time` string, nullable
    - `external_event_id` string, nullable
    - `id` string, required
    - `is_all_day` boolean
    - `self_response_status` string, nullable
    - `start_time` string, nullable
    - `title` string, nullable
  - `request_id` string, required
  - `total` integer, required

## Changes

- **2026-11-03** `503bb357d07c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/mem/apis/mem-public-client-api/changes/v2/calendar/events/get.md)

---

[API](https://skmtc.dev/mem/apis/mem-public-client-api.md) - [All operations](https://skmtc.dev/mem/apis/mem-public-client-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mem/apis/mem-public-client-api/revisions/503bb357d07c?raw)