Skip to main content
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://formitto.com/v1/calendar-widgets/44/bookings \
  -H "Authorization: Bearer fmt_live_xxxxxxxx"

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

​
Get a booking

GET /v1/bookings/{id} — scope read:bookings. 
curl https://formitto.com/v1/bookings/555 \
  -H "Authorization: Bearer fmt_live_xxxxxxxx"

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