POST

List Availability Time Slot End Options


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Retrieves the available end times for a selected start time of an appointment-based service configured with a duration range.

Call this after the customer selects a start time with List Availability Time Slots. Each returned entry is a TimeSlot that shares the requested localStartDate and differs only in localEndDate. The response doesn't include resource lists.

Only supported for hourly duration-range services (services with availabilityConstraints.durationRange.hourConfig configured in Services V2). Calling this for a fixed-duration or daily duration-range service returns END_OPTIONS_NOT_SUPPORTED.

Resource selection

Resource selection depends on the booking flow:

  • If the customer hasn't selected a resource yet, call Get Availability Time Slot with the selected localEndDate to retrieve candidate resources before booking.
  • If the customer selected a resource before the end time, pass that resource in resourceTypes so the response only includes end times that the selected resource can cover.

Time slot shape

The response uses the TimeSlot model with constrained semantics:

  • localStartDate and location are identical on every entry, echoing the request.
  • localEndDate varies across entries and represents each end option.
  • availableResources is always empty. Use Get Availability Time Slot to retrieve resources for a selected end time.
  • eventInfo, nestedTimeSlots, and allDay are not populated.
  • totalCapacity is always 1.
Permissions
Read Bookings Calendar Availability
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/_api/service-availability/v2/time-slots/end-options

Errors
400Invalid Argument

There is 1 error with this status code.

403Permission Denied

There is 1 error with this status code.

404Not Found

There are 3 errors with this status code.

428Failed Precondition

There is 1 error with this status code.

This method may also return standard errors. Learn more about standard Wix errors.

Did this help?