List bookings
Paginated facility bookings for the current organization. Members see their own bookings; managers see all bookings. Nested write, export, and search routes on this controller stay undocumented.
query Parameters
filter[user_id]Filter by owning user id. Members are limited to their own bookings regardless of this value.
filter[bookable_entity]Filter by facility (bookable entity) id(s), including child facilities of a parent. Comma-separated for multiple.
filter[id]Filter by exact booking id(s), comma-separated.
filter[recurring_id]Filter by the recurring series id.
filter[uuid]Filter by exact booking uuid.
filter[starting_at]Filter to bookings that start on or after this date/time.
filter[ending_at]Filter to bookings that end on or before this date/time.
filter[query]Search bookings by owner name or email, facility name, or booking id.
filter[associated_booking_id]Filter by the parent booking id for linked/child bookings. Pass an empty value to match bookings with no parent.
filter[only_recurring]When true, only bookings that belong to a recurring series.
filter[tags]Filter by tag name(s), comma-separated.
filter[with_product]Filter to bookings associated with the given product id.
includeInclude related resources (comma-separated). Options: user, guest, bookableEntity, bookableEntity.parent, associatedBooking, organization, bookingItems, tags, formSubmissions, recurringBooking, facilities, bookingContactDetails, products.
appendAppend computed attributes (comma-separated). Options include readable_start_time, readable_end_time, owner_name, owner_email, owner_telephone, invoices_paid, total_amount_of_invoices, participants.
sortSort field. Options: id, starting_at, ending_at. Prefix with - for descending.
page[number]Page number for pagination.
page[size]Number of results per page.
Headers
X-Api-VersionOptional API version for this request. When omitted, the server uses the default version. This documentation describes version 2026-08-25.
List bookings › Responses
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · requires: status, message, immediate | |
| type = object · requires: status, message, immediate +3 more |
statusmessageimmediateGet a booking
Returns a single facility booking, scoped to the current tenant.
path Parameters
bookingquery Parameters
includeInclude related resources (comma-separated). Options: bookableEntity, bookableEntity.parent, bookableEntity.parent.form, bookableEntity.form, notes, organization, tags, user, guest, formSubmissions, facilities, bookingItems, bookingContactDetails, recurringBooking, products, invoices.transactions.
appendAppend computed attributes (comma-separated). Options include combined_notes, owner_name, owner_email, owner_telephone, participants, facilities_with_cost, created_by.
Headers
X-Api-VersionOptional API version for this request. When omitted, the server uses the default version. This documentation describes version 2026-08-25.