In Wix Rentals, availability comes from the resources connected to a service, not from staff members. Wix combines each resource's working hours with the events already on its calendar, then offers the customer only the periods that fit the service's duration range.
Wix Rentals uses the Time Slots V2 API to expose that availability. The calls you make depend on the service's unit type.
To discover which rental services have availability across the catalog before checking a specific service's availability in detail, see catalog-wide availability.
A rental service is bookable through resources such as rooms, vehicles, and equipment. To set this up, create a resource type, connect the individual resources to it, and then set the service's primaryResourceType to that resource type's ID.
Each resource has its own working hours and its own business location. When a service has several resources, Wix assigns an available one at booking time.
A resource's schedule shapes both its availability and the number of bookings a reservation creates:
The service's unit type and the resource's schedule together determine every downstream call. The following table summarizes the 3 combinations:
| Unit type | Resource schedule | Availability calls | Bookings created | Calendar events | How to cancel |
|---|---|---|---|---|---|
| Hourly | Any | List Availability Time Slots, then List Availability Time Slot End Options | 1 booking covering the selected range | 1 event | Cancel Booking |
| Daily | Working hours | List Availability Time Slots with timeSlotsPerDay set to 1 | 1 booking per working day, linked in a group | 1 event per day | Cancel Multi Service Booking |
| Daily | 24/7 | List Availability Time Slots with timeSlotsPerDay set to 1 | 1 booking covering the full date range | 1 all-day event | Cancel Booking |
Learn more about how each path maps to the Bookings APIs.
For an hourly rental, the customer selects a start time first and then a length:
localStartDate to get the available end times. The end options run from the minimum duration up to either the maximum duration or the resource's next blocking event, whichever comes first. The service's maximum duration always caps the result, so you don't need to calculate an upper bound yourself.When several resources are free at the chosen start time, Wix returns the end options of the resource with the longest available window. At booking time, Wix assigns a resource that can cover the full selected duration. If the customer selects a resource before selecting an end time, pass that resource's type in resourceTypes so the response only includes end times that resource can cover.
The customerChoices field on the List Availability Time Slots request doesn't apply to a service with a duration range. Fixed-duration services use customerChoices to select a session length, while a rental's length comes from the start and end times the customer selects.
A daily rental needs only 1 call. Call List Availability Time Slots with timeSlotsPerDay set to 1 to get 1 slot per available day.
A day is available only when the resource's whole bookable period for that day is free. Any booking during that period makes the entire day unavailable. For a resource with working hours, the bookable period is that day's working hours. For a 24/7 resource, it's the full calendar day, from midnight to midnight.
Then calculate the valid end dates in your own code. Starting from the date the customer selected, iterate through consecutive available days and stop at the first unavailable day, at the first day the site is closed, or when you reach the service's maximum duration, whichever comes first.
Buffer time is relevant only to hourly services. For daily services, buffer time isn't applied.
Buffer time works the same way as in Wix Bookings. When an hourly service sets timeBetweenSessions, Wix expands each blocking event by that amount before calculating availability, so a rental can't start or end too close to an adjacent booking. You don't need to account for the buffer yourself.
To check availability across multiple rental services in a single call, instead of querying Time Slots V2 for 1 service at a time, use the Catalog Search API. Learn more about catalog search for rentals.
When you specify a date range in serviceFilters, the API checks whether each service has bookable slots in that window. How the window is matched depends on its shape and the service's unit type:
exactMatch set to true, the service must be bookable for the exact range, matched to the minute. With exactMatch undefined or false, at least 1 bookable slot in the window is enough.exactMatch: The service must be bookable on every day in the range. This returns no results for hourly rental services, because an exact multi-day booking isn't meaningful when booking by the hour.exactMatch: At least 1 bookable slot anywhere in the range is enough.Set includeUnavailable to true to also receive services that have no availability in the window, each marked available: false.
To see these calls in context, follow the Book an hourly rental and Book a daily rental with working hours sample flows, and the Find available rental services sample flow for catalog-wide availability.
Last updated: 20 August 2026