getServiceAvailability( )

Deprecated. Get Service Availability has been replaced with Time Slots SDK methods and will be removed on March 31, 2026. Depending on your service type, use the appropriate Time Slots API to replace it. See the End-to-End Booking Flows for implementation examples.

Service availability means different things for the different service types (SDK | Velo):

• Appointments: See here to understand what affects the availability of an appointment. An appointment is returned as available if it meets the conditions outlined in the article linked above and the appointment slot's time falls within the time specified by the AvailabilityOptions or within the default time frame if no options are specified.
• Classes: A class slot is returned as available if the slot's time falls within the time specified by the AvailabilityOptions or within the default time frame if no options are specified.
• Courses: The first session slot from a set of course sessions is returned as available if the first course slot's time falls within the time specified by the AvailabilityOptions or within the default time frame if no options are specified.

To understand how getServiceAvailability() is used in a typical booking lifecycle, see Typical Booking Lifecycle (SDK | Velo).

The specified serviceId must be an ID from the site's Bookings/Services collection. Typically, you retrieve the ID from the collection using a query or through a dataset.

Optionally, you can specify an AvailabilityOptions object that defines a date range for which slots should be returned. If you do not specify an AvailabilityOptions object, the default date range is from the date and time the method is called until one week later.