Overview
Returns the bookings in your workspace, newest first. Requires a token with theaccess_bookings scope.
Query Parameters
| Param | Type | Description |
|---|---|---|
status | string | Filter by lifecycle status: PENDING, CONFIRMED, DECLINED, CANCELLED, or COMPLETED. |
bookingTypeId | string | Filter to a single booking type by id. |
from | string (date-time) | Only bookings starting at/after this ISO-8601 instant. |
to | string (date-time) | Only bookings starting at/before this ISO-8601 instant. |
limit | number | Page size, 1-100. Defaults to 25. |
cursor | string | Opaque keyset cursor from a previous response’s nextCursor. |
Response
Returns{ bookings, nextCursor, hasMore }. Each booking includes its public
uid, status, start/end, duration, resolved hosts, the booker’s contact details
(your workspace’s own data), intake answers, and the location. Pass nextCursor
back as cursor to fetch the next page; hasMore is false on the last page.
Usage Notes
- Results are scoped to your token’s workspace — you can never read another workspace’s bookings.
- Manage tokens (
seatUid), idempotency keys, and ICS internals are never returned.