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

# List calendar events

`GET /v1/calendar-events`

## Request

- Base URL: `https://api.forwardemail.net`
- URL: `https://api.forwardemail.net/v1/calendar-events`
- Auth: HTTP basic

Retrieve a list of calendar events for the authenticated alias. This endpoint supports pagination and filtering by calendar, date range, and deletion status.

## Query parameters

- `calendar_id` string
- `start_date` string, date-time
- `end_date` string, date-time
- `include_deleted` boolean
- `page` integer
- `limit` integer

## Response `200`

List of calendar events

- CalendarEvent[]
  - `id` string, required: Calendar event ID (eventId from CalDAV)
  - `calendar_id` string, required: ID of the calendar this event belongs to
  - `ical` string, required: iCalendar (RFC 5545) data for the event
  - `summary` string: Event title/summary (extracted from iCal data)
  - `description` string: Event description (extracted from iCal data)
  - `location` string: Event location (extracted from iCal data)
  - `start_date` string, date-time: Event start date/time (extracted from iCal data)
  - `end_date` string, date-time: Event end date/time (extracted from iCal data)
  - `uid` string: Unique identifier from iCal data
  - `status` string: Event status (extracted from iCal data)
  - `organizer` string: Event organizer (extracted from iCal data)
  - `deleted_at` string, date-time, nullable: Soft deletion timestamp
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `object` 'calendar_event', required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/forwardemail/apis/forward-email-api.md) · [All operations](https://skmtc.dev/forwardemail/apis/forward-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/forwardemail/apis/forward-email-api/revisions/ecefab4527f6?raw)