Bookings - Sorraia API

A booking is a scheduled slot captured by a calendar widget. Bookings are read-only in v1.

The booking object

{
  "id": 555,
  "calendarWidgetId": 44,
  "inviteeName": "Jane Doe",
  "inviteeEmail": "[email protected]",
  "slotIso": "2026-06-01T10:00:00Z",
  "slotDisplay": "Jun 1, 2026, 10:00 AM",
  "inviteeTimezone": "America/New_York",
  "status": "scheduled",
  "customFields": {},
  "videoCallUrl": "https://meet.example.com/abc",
  "createdAt": "2026-05-20T09:30:00.000Z"
}

status is one of scheduled, cancelled, no_show, completed, or failed. Internal fields (cancellation tokens, provider event IDs, assigned host) are never exposed.

List a calendar’s bookings

GET /v1/calendar-widgets/{id}/bookings — scope read:bookings. Paginated (page, limit), newest first.

curl https://api.sorraia.app/v1/calendar-widgets/44/bookings \
  -H "Authorization: Bearer sor_live_xxxxxxxx"

const result = await sorraia.bookings.listCalendarBookings({ id: 44 });

Get a booking

GET /v1/bookings/{id} — scope read:bookings.

curl https://api.sorraia.app/v1/bookings/555 \
  -H "Authorization: Bearer sor_live_xxxxxxxx"

const booking = await sorraia.bookings.getBooking({ id: 555 });