List and read bookings
The meetings guests booked, for every page of the person or for one.
Runs any of 2 calls on your workspace.
GET /bookings
The meetings guests booked, for every page of the person or for one.
Example
Needs calendar:read. view is upcoming (the default), pending, past or ended. pageId narrows the list to one page, limit goes up to 100 and defaults to 30, and cursor takes the previous page’s nextCursor.
curl "$OE/bookings?view=pending" -H "$AUTH"curl "$OE/bookings?q=ann&from=2026-11-01T00:00:00Z&to=2026-12-01T00:00:00Z" -H "$AUTH"curl "$OE/bookings/bkg_2b8d4f6a1c3e5079b6d8f0a2" -H "$AUTH"{ "object": "list", "data": [{ "object": "booking", "id": "bkg_2b8d4f6a1c3e5079b6d8f0a2", "pageId": "bkp_5c1e9a7b3d2f48e6a0b4c7d1", "pageName": "Intro call", "status": "confirmed", "expired": false, "past": false, "start": "2026-11-03T09:00:00.000Z", "end": "2026-11-03T09:30:00.000Z", "durationMinutes": 30, "guest": { "name": "Ann Lee", "email": "[email protected]", "timezone": "America/New_York" }, "guests": [], "answers": [ { "id": "notes", "label": "Anything we should know?", "kind": "long-text", "value": "I would like to talk about pricing." } ], "location": "https://meet.example.com/hana", "eventId": "evt_8a1c3e5f7b2d4960c8e0a2b4", "endedBy": null, "endReason": null, "rescheduleCount": 0, "guestMailFailed": false, "createdAt": "2026-10-28T14:12:40.115Z" }], "hasMore": false, "nextCursor": null}upcoming holds confirmed meetings that are not over, pending the requests waiting for approval, and ended the declined and cancelled ones. upcoming and pending come soonest first, the other two latest first.
expired is true for a request nobody answered before its time came.
A booking follows its calendar event. A meeting moved or cancelled in the calendar, or declined by the guest in theirs, reads that way here.
guestMailFailed is true when the last email to the guest could not be sent.
guests lists the email addresses of the other people invited: the ones the guest added when booking, and anyone added to the calendar event since.
pageIds keeps the bookings of some pages, as ids separated by commas. q finds bookings by the name or email of the guest, or the name of the page. from and to keep the meetings that start in a window.