Skip to the documentation
API

List the calendar

Every occurrence between two moments, a repeating event once for each time it happens, sorted by start.

GET/calendar/events

Runs the real call on your workspace.

GET /calendar/events

Every occurrence between two moments, a repeating event once for each time it happens, sorted by start.

Example

Needs calendar:read. from and to are ISO 8601 with a zone and at most a year apart, and timezone is the IANA zone that decides what an all-day event means, UTC unless you say.

curl
curl "$OE/calendar/events?from=2026-10-12T00:00:00Z&to=2026-10-19T00:00:00Z&timezone=Europe/London" -H "$AUTH"
Response
{  "object": "list",  "data": [    {      "object": "calendar_occurrence",      "eventId": "cal_3f9a1c7e5b2d48a06c1e9f4b",      "uid": "5d2c8e1a-7b3f-4c9d-a6e2-1f8b0c4d7e93@openemail",      "start": "2026-10-12T09:00:00.000Z",      "end": "2026-10-12T09:30:00.000Z",      "allDay": false,      "summary": "Planning",      "location": "Room 2",      "status": "CONFIRMED",      "transparency": "OPAQUE",      "isOrganizer": true,      "organizerEmail": "[email protected]",      "recurring": true,      "myPartstat": null,      "attendeeCount": 1    }  ],  "hasMore": false,  "nextCursor": null}

Each occurrence names its event in eventId, and myPartstat is your own answer. A key or app limited to some addresses sees only the events one of them organises or attends.

Reference