List booking requests
Paginated booking requests for the current tenant. Members see their own
requests; facility managers and super admins see the full list. The
default row is a curated payload (schedule, cost, owner, facility, state).
Pass include / append for the richer relations the product UI uses.
query Parameters
filter[query]Search by owner name, facility name, or organization name.
filter[bookable_entity_id]Filter by bookable entity id(s). Also matches child facilities of a parent entity. Comma-separated.
filter[booking_state_id]Filter by booking state id(s). Comma-separated. Include the declined sentinel to also return declined requests.
filter[user_id]Filter by owning member id. Non-managers may only use their own id.
filter[starting_at]Filter to requests that start on or after this datetime.
filter[ending_at]Filter to requests that end on or before this datetime.
filter[uuid]Look up a single request by its public uuid.
filter[recurring_id]Filter to requests in a recurring series.
filter[tags]Filter by tag name(s). Comma-separated.
includeInclude related resources (comma-separated). Options: bookableEntity, bookableEntity.parent, bookableEntity.form, guest, user, bookingState, transaction, organization, bookingItems, tags, bookingContactDetails, recurringBooking, formSubmissions, files, notes, facilities.
appendAppend computed attributes (comma-separated). Options: owner_name, owner_email, owner_telephone, invoices_paid, total_amount_of_invoices, combined_notes, associated_recurring_ids, flat_total_for_user_and_availability, next_state, previous_state, participant_name (facility managers and super admins only).
sortSort by id, starting_at, or 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 booking requests › Responses
Paginated set of BookingRequestResource
current_pagefromlast_pageper_pagetototalGet a booking request
Returns a single booking request. Members may only view their own; facility managers and super admins may view any request in the tenant.
path Parameters
booking_requestquery Parameters
includeInclude related resources (comma-separated). Options: bookableEntity, bookableEntity.parent, bookableEntity.form, guest, user, bookingState, transaction, files, notes, organization, recurringBooking, tags, formSubmissions, formSubmissions.form, bookingContactDetails, bookingItems, facilities.
appendAppend computed attributes (comma-separated). Options: remaining_recurring_bookings, combined_notes, owner_name, owner_email, owner_telephone, created_by, facilities_with_cost, next_state, previous_state, participant_name (facility managers and super admins only).
Headers
X-Api-VersionOptional API version for this request. When omitted, the server uses the default version. This documentation describes version 2026-08-25.
Get a booking request › Responses
BookingRequestResource
iduuidPublic identifier used by guest form links.
starting_atending_atcostQuoted cost in integer cents.
reasondisplay_textOptional calendar label.
declined_atdecline_reasonuser_idguest_idorganization_idbookable_entity_idbooking_state_idrecurring_idtransaction_idform_responses_lockedcreated_atupdated_atdeletion_reasondeleted_atreadable_start_timereadable_end_timecan_cancelWhether the owner may still cancel this request.
starting_at_utc_tsUnix timestamp of starting_at in UTC.
ownerResolved booking contact. Prefer this over the raw user/guest/organization relations.
Facility this request is for. Slim {id, name} by default; the full
bookable entity is returned when include=bookableEntity is sent.
Workflow state. Slim {id, state_name, color} by default; the full
state model is returned when include=bookingState is sent.
userguestorganizationbooking_itemstagsfilesnotesform_submissionsrecurring_bookingbooking_contact_detailstransactionfacilitiesstarting_at_tscombined_notestotal_amount_of_invoicesinvoices_paidassociated_recurring_idsreadable_booking_item_one_namereadable_booking_item_two_namereadable_booking_item_one_descriptionreadable_booking_item_two_descriptionmost_expensive_hourly_ratecost_for_user_and_availabilityflat_total_for_user_and_availabilityowner_nameowner_emailowner_telephoneparticipantsparticipant_nameremaining_recurring_bookingsbooking_item_onebooking_item_twofacilities_with_costcreated_bynext_stateThe state this request advances to next in the facility's workflow.
Present when append=next_state is requested; null when the request is already in the final state.
previous_stateThe state this request can be moved back to.
Present when append=previous_state is requested; null when the request is in the first state.