---
title: "Index Calendar Events"
method: GET
path: "/api/calendars/{calendar_public_id}/events"
tags: ["Events"]
---

# Index Calendar Events

`GET /api/calendars/{calendar_public_id}/events`

## Request

- Base URL: `https://addcal.co`
- URL: `https://addcal.co/api/calendars/{calendar_public_id}/events`
- Auth: none required

## Query parameters

- `range` string: Filter events by time range. Options: 'all', 'upcoming', 'past'
- `search` string: Search events by title or internal name
- `calendar` string: Filter events by calendar ID
- `start_date` string: Filter events starting from this date (ISO 8601 format)
- `end_date` string: Filter events ending before this date (ISO 8601 format)
- `rsvp` boolean: Only return events with RSVPs enabled (true) or disabled (false)
- `invites` boolean: Only return events with calendar invites enabled (true) or disabled (false)

## Request body

- object
  - `range` 'all' | 'upcoming' | 'past'
  - `search` string: Must not be greater than 255 characters.
  - `calendar` string: Must not be greater than 255 characters.
  - `start_date` string: Must be a valid date.
  - `end_date` string: Must be a valid date.
  - `rsvp` '1' | '0' | 'true' | 'false'
  - `invites` '1' | '0' | 'true' | 'false'

## Response `200`

- object
  - `data` object[]
    - `uid` string
    - `public_id` string
    - `calendar_uid` string
    - `short_link` string, nullable
    - `title` string
    - `internal_name` string, nullable
    - `is_draft` boolean
    - `description` string
    - `location` string
    - `is_all_day` boolean
    - `has_rsvp` boolean
    - `has_calendar_invites` boolean
    - `rsvp_limit` string, nullable
    - `is_recurring` boolean
    - `recurrence_rule` string, nullable
    - `recurrence_text` string, nullable
    - `date_start` string
    - `date_end` string
    - `timezone` string, nullable
    - `busy_type` string, nullable
    - `reminder_before` string, nullable
    - `date_range_formatted` string
    - `public_url` string
    - `embed_url` string
    - `location_url` string, nullable
    - `image_url` string, nullable
    - `timezone_readable` string, nullable
    - `calendar` object
      - `uid` string
      - `public_id` string
      - `short_link` string, nullable
      - `name` string
      - `internal_name` string
      - `description` string
      - `timezone` string
      - `week_begins` integer
      - `public_url` string
      - `created_at` string
      - `updated_at` string
    - `created_at` string
    - `updated_at` string

---

[API](https://skmtc.dev/addcal/apis/addcal-api-documentation.md) · [All operations](https://skmtc.dev/addcal/apis/addcal-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/addcal/apis/addcal-api-documentation/revisions/addd0607e492?raw)