---
title: "List workspace calendar events (v2)"
method: GET
path: "/v2/workspaces/{workspaceId}/calendar/events"
tags: ["workspaces"]
---

# List workspace calendar events (v2)

`GET /v2/workspaces/{workspaceId}/calendar/events`

## Request

- Base URL: `https://api.prod.getdex.com`
- URL: `https://api.prod.getdex.com/v2/workspaces/{workspaceId}/calendar/events`
- Auth: HTTP bearer

One window of the workspace calendar, `start` to `end` (ISO 8601 with offset, at most 7 days apart, plus an hour for a week that crosses a DST change; the start's offset decides which days teammates' all-day events fall on). `calendar_events` are your own events from the accounts whose calendar you share with this workspace, at any share level, in the shape of `GET /v2/agenda/calendar/events`: they are not redacted and not limited to workspace contacts, and an account you never shared here is never read. `shared_events` are teammates' meetings with the workspace's contacts, redacted to each share's level like the shared-activity items, excluding meetings you also hold. `warnings` lists calendars that could not be read. Returns `{ data: { calendar_events, pagination, shared_events, warnings? } }`.

## Path parameters

- `workspaceId` string, uuid, required

## Query parameters

- `start` string, date-time, required
- `end` string, date-time, required

## Response `200`

Successful response

- object
  - `data` object, required
    - `calendar_events` object[], required
      - `providerId` string, required
      - `type` 'EMAIL' | 'CALENDAR', required
      - `subjectOrTitle` string, required
      - `dateTime` union, required
        - string, date-time
        - unknown
      - `endDateTime` union
        - string, date-time
        - unknown
      - `isAllDay` boolean, nullable
      - `participants` object[], required
        - `email` string, required
        - `name` string, nullable
      - `providerLink` string, nullable
      - `email` string, required
      - `iCalUID` string, nullable
      - `summaryOfEvent` string, nullable
      - `descriptionOfEvent` string, nullable
      - `conferenceData` object, nullable
        - `conferenceId` string, nullable
        - `entryPoints` object[], nullable
          - `uri` string, nullable
          - `label` string, nullable
          - `accessCode` string, nullable
      - `isRecurring` boolean, nullable
      - `provider` string, nullable
    - `pagination` object
      - `nextCursor` string, nullable
      - `count` integer
    - `warnings` string[]: Incomplete results: some connected calendars could not be read.
    - `shared_events` object[], required
      - `id` string, required
      - `type` 'EMAIL' | 'CALENDAR', required
      - `thread_id` string, nullable, required
      - `date` string, date-time, required
      - `end_date` string, date-time, nullable, required
      - `is_all_day` boolean, required
      - `member_user_ids` string[], required
      - `visibility` 'metadata' | 'full', required
      - `subject` string, required
      - `from` object, nullable, required
        - `email` string, required
        - `name` string, nullable, required
      - `participants` object[], required
        - `email` string, required
        - `name` string, nullable, required
        - `role` 'from' | 'to' | 'cc' | 'attendee' | 'organizer', nullable, required
      - `snippet` string, nullable, required
      - `description` string, nullable, required
      - `has_body` boolean, required
      - `provider` 'GOOGLE' | 'OFFICE365', required

## Other responses

- `400`: Request body failed validation.
- `401`: Missing or invalid API key.
- `403`: Valid key, insufficient permission.
- `404`: Resource does not exist.
- `409`: Request conflicts with the current state of the resource.
- `429`: Rate limit exceeded.
- `500`: Unexpected server error.

## Changes

- **2026-10-21** `0f58a167f636`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getdex/apis/dex-public-api/changes/v2/workspaces/:workspaceId/calendar/events/get.md)

---

[API](https://skmtc.dev/getdex/apis/dex-public-api.md) · [All operations](https://skmtc.dev/getdex/apis/dex-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getdex/apis/dex-public-api/revisions/657247ddcf7c?raw)