@wix/auto_sdk_bookings_multi-service-availability-time-slots 1.0.156 → 1.0.158

package/build/es/index.typings.d.mts

@@ -1,193 +1,185 @@
 import { NonNullablePaths } from '@wix/sdk-types';
 
 /**
- * The `TimeSlot` object represents the availability information
- * for an `Appointment` service's specific slot, including:
+ * A time slot represents a specific time period when a service is available for booking.
+ * It provides all the information needed to display availability to customers, including whether customers can actually book it, the remaining capacity, and which staff members or resources are available.
+ * Available time slots may not always be bookable due to service booking policies - when this occurs, the time slot includes information about the specific booking restrictions.
  *
- * 1. Whether the slot is bookable for the given service?
- *
- * 2. In what location the service is available for this slot?
- *
- * 3. Which available resources can provide the service for this slot?
- *
- * 4. Does booking the slot for the service violates any of the service booking policies?
- *
- * 5. What is the total capacity and remaining capacity of the service at the time of the calculation of the `TimeSlot`?
- *
- * > __Note:__
- * > When the `TimeSlot` has a non empty `NestedTimeSlots`, it represents the availability information
- * > for a given list of `Appointment` services within a specific time slot.
+ * For multi-service bookings, the top-level time slot acts as a container spanning the entire service sequence (from the start of the first service to the end of the last service). Individual service details are provided in nested time slots.
  */
 interface TimeSlot {
     /**
-     * Service ID.
+     * Service ID ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/introduction)).
      *
-     * > Not returned from `MultiServiceAvailabilityTimeSlots` API calls.
-     * > Instead, each nested time slot has its own serviceId.
+     * Available only for single-service bookings. For multi-service bookings, this field is empty and individual service IDs are provided in `nestedTimeSlots`.
      * @format GUID
      */
     serviceId?: string | null;
     /**
-     * Local start date of the time slot in ISO-8601 format.
-     * For example, "2024-01-30T13:30:00".
+     * Local start date of the time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
+     *
+     * For multi-service bookings, this represents the start time of the first service in the sequence.
      * @format LOCAL_DATE_TIME
      */
     localStartDate?: string | null;
     /**
-     * Local end date of the time slot in ISO-8601 format.
-     * For example, "2024-01-30T14:30:00".
+     * Local end date of the time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T14:00:00`.
+     *
+     * For multi-service bookings, this represents the end time of the last service in the sequence.
      * @format LOCAL_DATE_TIME
      */
     localEndDate?: string | null;
     /**
-     * Whether the slot is bookable according to the service's booking policies.
+     * Whether customers can book the slot according to the service's booking policies ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/booking-policies/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/policies/booking-policies/introduction)).
      *
-     * If booking this time slot does not violates any of the service's booking policies,
-     * the returned value is `true`. Otherwise, returns `false`.
+     * For multi-service bookings, this is `true` only when all services in the sequence comply with their respective booking policies.
      */
     bookable?: boolean | null;
-    /** The geographic location of the slot. */
+    /** Information about where the business provides the service to the customer. */
     location?: Location;
-    /** The event information if the time slot is an event based slot. */
+    /**
+     * Information about the event ([SDK](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/introduction)) related to the slot.
+     * Available only for classes. Not available for appointment-based services and courses.
+     */
     eventInfo?: EventInfo;
     /**
      * Total number of spots for the slot.
+     *
+     * For multi-service bookings, this is always `1` because customers book the entire service sequence as a single unit.
      * @min 1
      * @max 1000
      */
     totalCapacity?: number | null;
     /**
      * Remaining number of spots for the slot.
-     * For example, for an appointment service with total capacity of 1 spot and one booked spot, the remaining capacity will be 0.
+     * This is calculated as total capacity minus booked spots, but doesn't account for waitlist reservations.
+     *
+     * If the service has a waitlist enabled, use `bookableCapacity` instead to get the accurate number of spots customers can actually book.
+     *
+     * For single-service bookings: An appointment service with total capacity of 3 spots and 1 booked spot results in a remaining capacity of `2`.
+     * For multi-service bookings: This is either `1` (sequence available) or `0` (sequence unavailable).
      * @max 1000
      */
     remainingCapacity?: number | null;
     /**
-     * Number of spots in the slot that are available for booking.
-     * This is calculated as the remaining capacity minus the spots reserved for the waiting list.
+     * Number of spots that customers can book for the slot.
+     * Calculated as the remaining capacity minus the spots reserved for the waitlist.
+     * If the service has no waitlist, identical to `remainingCapacity`.
+     *
+     * For multi-service bookings, this is either `1` (sequence can be booked) or `0` (sequence cannot be booked).
      */
     bookableCapacity?: number | null;
     /**
-     * Indicators for booking policy violations for the slot.
+     * Information about booking policy violations for the slot.
      *
-     * Each nested field is checked on its own. i.e. if `tooEarlyToBook` is defined and `bookOnlineDisabled` is not defined
-     * we will return also slots for which `tooEarlyToBook` is same as on the request, regardless of `bookOnlineDisabled`.
+     * For multi-service bookings, this aggregates violations from all services in the sequence.
      */
     bookingPolicyViolations?: BookingPolicyViolations;
     /**
-     * List of `AvailableResources` for the time slot.
-     * Each `AvailableResources` contains information about available resources of the same type.
+     * List of resources ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-v2/introduction)) available during the time slot.
      *
-     * > Not returned from `MultiServiceAvailabilityTimeSlots` API calls.
-     * > Instead, each nested time slot has its own available resources.
+     * Available only for single-service bookings. For multi-service bookings, resource information is provided in `nestedTimeSlots`.
      */
     availableResources?: AvailableResources[];
     /**
-     * > Nested time slots.
-     * > Returned only from `MultiServiceAvailabilityTimeSlots` API calls.
+     * Nested time slots for multi-service bookings.
+     * Each nested slot represents 1 service in the sequence, ordered according to the service sequence specified in the request.
+     *
+     * Available only for multi-service bookings. Empty for single-service bookings.
      * @maxSize 8
      */
     nestedTimeSlots?: NestedTimeSlot[];
-    /** Reasons why the time slot is not available for booking. */
+    /** Information about why customers can't book the time slot. */
     nonBookableReasons?: NonBookableReasons;
     /**
-     * The schedule ID associated with this time slot.
-     * Same as the service’s schedule ID.
+     * Schedule ID associated with this time slot.
+     * Same as the service's schedule ID.
      * @format GUID
      */
     scheduleId?: string | null;
 }
 interface Location {
     /**
-     * Business Location ID. Present only if the location is a business location.
+     * Location ID ([SDK](https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/locations/introduction)).
+     * Available only for business locations.
      * @format GUID
      */
     _id?: string | null;
-    /** The location name. */
+    /** Location name. */
     name?: string | null;
-    /** A string representation for the full address of the location. */
+    /** Formatted location address. */
     formattedAddress?: string | null;
-    /**
-     * The type of location:
-     * - `CUSTOM`: The location is specific to this service, and is not derived from the business location.
-     * - `BUSINESS`: A business location, either the default business address, or locations defined for the business by the Business Info.
-     * - `CUSTOMER`: The location is determined by the customer and is not set up beforehand.
-     */
+    /** Location type. */
     locationType?: LocationTypeWithLiterals;
 }
 declare enum LocationType {
     UNKNOWN_LOCATION_TYPE = "UNKNOWN_LOCATION_TYPE",
     /** A business location, either the default business address, or locations defined for the business by the Business Info. */
     BUSINESS = "BUSINESS",
-    /** The location is unique to this service and isn't defined as one of the business locations. */
+    /** The location is unique to this service and isn't defined as 1 of the business locations. */
     CUSTOM = "CUSTOM",
-    /** The location can be determined by the customer and is not set up beforehand. */
+    /** The location can be determined by the customer and isn't set up beforehand. */
     CUSTOMER = "CUSTOMER"
 }
 /** @enumType */
 type LocationTypeWithLiterals = LocationType | 'UNKNOWN_LOCATION_TYPE' | 'BUSINESS' | 'CUSTOM' | 'CUSTOMER';
-/** relevant for event based slots, and not for availability based slots */
+/** Available for event based slots, and not for availability based slots */
 interface EventInfo {
     /**
-     * The event ID.
+     * Event ID.
      * @minLength 36
      * @maxLength 250
      */
     eventId?: string | null;
-    /** Waiting list details for the event, if enabled in the service's booking policy. */
+    /** Information about the event's waitlist. Available only if the service has a waitlist. */
     waitingList?: WaitingList;
 }
 interface WaitingList {
     /**
-     * Total number of spots in the waiting list.
+     * Total number of spots in the waitlist.
      * @min 1
      */
     totalCapacity?: number | null;
     /**
-     * Number of remaining spots in the waiting list.
-     * For example, a yoga event with a capacity of `10` and `3` registrants will have a `remainingCapacity` of `7`.
+     * Number of remaining spots in the waitlist.
+     * For example, an event with a waitlist for 10 people and 3 registrants, results in a remaining capacity of `7`.
      */
     remainingCapacity?: number | null;
 }
 interface BookingPolicyViolations {
-    /** Bookings policy violation. Too early to book this slot. */
+    /** Whether it's too early for customers to book the slot. */
     tooEarlyToBook?: boolean | null;
-    /** The earliest time at which booking for this slot is allowed, in UTC format (`YYYY-MM-DDThh:mm:ss.sssZ`). */
+    /** Earliest time for booking the slot in `YYYY-MM-DDThh:mm:ss.sssZ` format. */
     earliestBookingDate?: Date | null;
-    /** Bookings policy violation. Too late to book this slot. */
+    /** Whether it's too late for customers to book the slot. */
     tooLateToBook?: boolean | null;
-    /** Bookings policy violation. Online booking is disabled for the `TimeSlot` service. */
+    /** Whether customers can book the service online. */
     bookOnlineDisabled?: boolean | null;
 }
 interface AvailableResources {
     /**
-     * Resource type ID.
+     * Resource type ID ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resource-types/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resource-types-v2/introduction)).
      * @format GUID
      */
     resourceTypeId?: string | null;
     /**
-     * Available resources for the time slot.
-     *
-     * + When returned from `ListAvailabilityTimeSlots`, empty by default.
-     * + + If you provided `includeResourceTypeIds` or  `resourceIds` in request,
-     * contains __up__ to 10 available resources out of those provided.
-     *
-     * + When returned from `GetAvailabilityTimeSlots`, contains all available resources by default.
-     * + + If you provided `includeResourceTypeIds` or  `resourceIds` in request,
-     * contains all of the available resources out of those provided.
+     * Details about resources available during the time slot.
      *
+     * Behavior varies by method:
      *
-     * > + When returned from `ListMultiServiceAvailabilityTimeSlots`, empty by default.
-     * > + + If you provided `includeResourceTypeIds` or  `resourceIds` in request,
-     * > contains __up__ to 10 available resources out of those provided.
+     * List methods (List Availability Time Slots and List Multi Service Availability Time Slots):
+     * - Empty by default.
+     * - Up to 10 resources when specifying `includeResourceTypeIds` or `resourceIds` in the request.
      *
-     * > + When returned from `GetMultiServiceAvailabilityTimeSlots`, contains all available resources by default.
-     * > + + If you provided `includeResourceTypeIds` or  `resourceIds` in request,
-     * > contains all of the available resources out of those provided.
+     * Get methods (Get Availability Time Slots and Get Multi Service Availability Time Slots):
+     * - All resources by default.
+     * - Filtered resources when specifying `includeResourceTypeIds` or `resourceIds` in the request.
      */
     resources?: Resource[];
     /**
-     * Whether there are more available resources for the slot that are not listed in `resources` due to size limitations.
+     * Whether there are more available resources for the slot than those listed in `resources`.
      * @readonly
      */
     hasMoreAvailableResources?: boolean | null;
@@ -211,20 +203,19 @@ interface NestedTimeSlot {
      */
     serviceId?: string;
     /**
-     * Local start date of the nested time slot in ISO-8601 format.
-     * For example, "2024-01-30T13:30:00".
+     * Local start date of the nested time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
      * @format LOCAL_DATE_TIME
      */
     localStartDate?: string;
     /**
-     * Local end date of the nested time slot in ISO-8601 format.
-     * For example, "2024-01-30T14:30:00".
+     * Local end date of the nested time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
      * @format LOCAL_DATE_TIME
      */
     localEndDate?: string;
     /**
-     * List of `AvailableResources` for the nested time slot.
-     * Each `AvailableResources` contains information about available resources of the same type.
+     * List of resources ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-v2/introduction)) available during the nested time slot.
      * @maxSize 10
      */
     availableResources?: AvailableResources[];
@@ -236,129 +227,76 @@ interface NestedTimeSlot {
     scheduleId?: string | null;
 }
 interface NonBookableReasons {
-    /** The slot is fully booked with no remaining capacity. */
+    /** Whether the slot is fully booked with no remaining capacity. */
     noRemainingCapacity?: boolean | null;
-    /** Booking this slot would violate the service's booking policy. */
+    /** Whether booking the slot violates any of the service's booking policies. */
     violatesBookingPolicy?: boolean | null;
-    /** The slot is reserved for the waiting list and not available for direct booking. */
+    /** Whether the slot is reserved for the waitlist. A new customer can't book the reserved slot. */
     reservedForWaitingList?: boolean | null;
 }
 interface ListMultiServiceAvailabilityTimeSlotsRequest {
     /**
-     * Services for which the multiService time slots are being returned for.
-     * Each service contains its own resources filters within.
+     * Services for which the multi-service time slots are returned.
+     * Each service can include its own resource filters.
      *
-     * MinSize: `2`.
-     * MaxSize: `8`.
-     *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Required unless you specify `cursorPaging.cursor`.
      * @maxSize 8
      */
     services?: Service[];
     /**
-     * Lower boundary for `localStartDate` to include in response, in ISO-8601 format.
-     * For example, "2024-01-30T13:30:00".
-     *
-     * Each returned `TimeSlot` in response has a `localStartDate`
-     * within the provided `fromLocalDate` and `toLocalDate` exclusive.
+     * Lower boundary for `localStartDate` in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
+     * Each returned time slot has a `localStartDate` between `fromLocalDate` and `toLocalDate`.
      *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Required unless you specify `cursorPaging.cursor`.
      * @format LOCAL_DATE_TIME
      */
     fromLocalDate?: string | null;
     /**
-     * Upper boundary for `localStartDate` to include in response, in ISO-8601 format.
-     * For example, "2024-01-30T14:30:00".
+     * Upper boundary for `localToDate` in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
+     * Each returned time slot has a `localEndDate` between `fromLocalDate` and `toLocalDate`.
      *
-     * Each returned `TimeSlot` in response has a `localStartDate`
-     * within the provided `fromLocalDate` and `toLocalDate` exclusive.
-     *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Required unless you specify `cursorPaging.cursor`.
      * @format LOCAL_DATE_TIME
      */
     toLocalDate?: string | null;
     /**
-     * Time zone, in IANA time zone format.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate` values. For example, `America/New_York` or `UTC`.
+     *
+     * Required unless you specify `cursorPaging.cursor`.
      *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @minLength 1
      * @maxLength 150
      */
     timeZone?: string | null;
     /**
-     * Location for which the multiService TimeSlots are being returned for.
+     * Location for which the multi-service time slots are returned. If you filter by `{"type": "BUSINESS"}`, you must also specify a location ID. A filter for `location.name` is ignored.
      *
-     * You can specify location or location type for which the TimeSlots will be returned for.
-     * If locationType is `BUSINESS`, you __must__ provide a locationId.
-     *
-     * <blockquote class="warning">
-     * <p><strong>warning:</strong><br/>
-     * Supports filtering by location type, or by location ID. </br>
-     * Other fields like <code class="grey-background">name</code> are ignored.</p>
-     * </blockquote>
-     *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Required unless you specify `cursorPaging.cursor`.
      */
     location?: Location;
     /**
-     * Whether the `TimeSlot` is bookable according to all of the services booking policies.
-     *
-     * If booking any of the `TimeSlot`.`NestedTimeSlot`s violates any of its services bookings policies,
-     * returns as `false`. Otherwise, returns as `true`.
-     *
-     * > __Note:__
-     * > A `TimeSlot` with a `NestedTimeSlot` that doesn't meet its service's bookings policies will be returned with `bookable` = false,
-     * > while a `TimeSlot` with no available resources will not be returned at all.
+     * Whether the time slot is bookable according to all services' booking policies.
+     * If not specified, returns both bookable and non-bookable time slots.
      */
     bookable?: boolean | null;
     /**
-     * Indicators for service's booking policy violations for booking the `TimeSlot`.
-     *
-     * A bookable time slot must not violate any policy,
-     * therefor, this filter is only relevant when `bookable` filter is false.
-     *
-     * Each nested field is checked on all `NestedTimeSlot`s. For example, if only one of the `NestedTimeSlot`'s
-     * has a service with `tooEarlyToBook` same as in the request, we return the `TimeSlot` regardless of whether
-     * the other `NestedTimeSlots` has the same `tooEarlyToBook` as in request.
-     *
-     * Each nested field is checked on its own. For example, if `tooEarlyToBook` is defined and `bookOnlineDisabled` is not defined
-     * we return slots for which `tooEarlyToBook` is same as on the request, regardless of `bookOnlineDisabled`.
+     * Indicators for service's booking policy violations.
+     * Only relevant when `bookable` filter is false.
      */
     bookingPolicyViolations?: BookingPolicyViolations;
     /**
-     * Maximum number of slots to load for each day. For example, if `timeSlotsPerDay` is set to `3`,
-     * we return at most 3 available TimeSlots for each day within the date range specified in request.
-     *
-     * By default,
-     * if `bookable` filter was not specified,
-     * and a day has both `bookable` and `un-bookable` slots, `bookable` slots are returned first.
-     *
-     * If the number of `bookable` slots is less than the requested `timeSlotsPerDay`,
-     * `un-bookable` slots will be returned according to the specified filters.
+     * Maximum number of slots to return for each day in the specified time range.
+     * If `bookable` filter isn't specified, bookable slots are returned first.
      */
     timeSlotsPerDay?: number | null;
     /**
-     * CursorPaging.
-     *
-     * Enables you to fetch TimeSlots in smaller, more manageable chunks
-     * by setting a limit on the number of results returned in response.
-     * This is useful in order to enhance efficiency of data retrieval and reduce load on both the client and server.
-     *
-     * If there are more results than the specified limit, the response will contain a `cursorPagingMetaData`
-     * with a cursor pointing to next page of results. In order to fetch the next page of results, you should pass the
-     * returned cursor to the next call as `cursorPaging`.`cursor`.
-     *
-     * For the first call, you should only specify the `limit` for the results page.
-     * For each following call, you should only pass the previous returned cursor as `cursorPaging`.`cursor`
-     * the `cursorPaging`.`limit`. You may pass a different `limit`.
-     * No need to specify any additional parameters.
-     *
-     * <blockquote class="important">
-     * <p><strong>Important:</strong><br/>
-     * If you only provide a <code class="grey-background">cursorPaging</code>. <code class="grey-background">cursor</code>,
-     * the response will contain the default size of results which is `1000`.
-     * </p>
-     * </blockquote>
+     * Cursor-based paging configuration.
+     * Enables fetching results in smaller chunks by setting a limit on the number of results.
+     * For consistent pagination behavior, use the same `limit` value throughout a pagination sequence.
+     * When specifying a new `limit` in follow-up requests, the API respects the new value.
      */
     cursorPaging?: CursorPaging;
 }
@@ -369,18 +307,18 @@ interface Service {
      */
     serviceId?: string;
     /**
-     * Resources to include in response.
+     * ID of the resources ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-v2/introduction)) to include in response.
      * @format GUID
      * @maxSize 135
      */
     resourceIds?: string[];
     /**
-     * The resource type ID's to include in returned time slots.
+     * Resource type IDs ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resource-types/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resource-types-v2/introduction)) to include in returned time slots.
      * This is in addition to the specifically requested resources.
      *
-     * <blockquote class="important">
+     * <blockquote>
      * Currently supported only for Staff Member resource type.
-     * Staff Member type ID: 1cd44cf8-756f-41c3-bd90-3e2ffcaf1155
+     * Staff members belong to resource type ID `cd44cf8-756f-41c3-bd90-3e2ffcaf1155`.
      * </blockquote>
      * @format GUID
      * @maxSize 100
@@ -388,9 +326,9 @@ interface Service {
     includeResourceTypeIds?: string[];
     /**
      * Selected customer choices.
-     * If specified, the selected choices will be used to calculate service configuration.
-     * If not specified, the service default configuration will be used.
-     * Enforcing this field is the responsibility of the SPI implementer, and not by the Availability API.
+     * If specified, the selected choices are used to calculate service configuration.
+     * If not specified, the service default configuration is used.
+     * Enforcing this field is the responsibility of the service plugin implementer, and not the Time Slots V2 API.
      */
     customerChoices?: V2CustomerChoices;
 }
@@ -400,22 +338,24 @@ interface Service {
  */
 interface V2CustomerChoices {
     /**
-     * The selected customer duration in minutes.
-     * Min: `1 minute`
-     * Max: `44639 minutes` (30 days, 23 hours, and 59 minutes)
+     * Selected customer duration in minutes.
+     * Min: `1` minute
+     * Max: `44639` minutes (30 days, 23 hours, and 59 minutes)
+     * Default: `15` minutes
      * @min 1
      * @max 44639
      */
     durationInMinutes?: number | null;
     /**
-     * The selected add-ons IDs.
-     * Max: Derived from max amount of Add-On groups * max amount of Add-Ons per group.
+     * Selected add-on IDs.
+     *
+     * Max: Calculated as the product of the maximum number of add-on groups multiplied by the maximum number of add-ons per group. Currently 21 (3 groups × 7 add-ons per group), but may change in the future.
      * @format GUID
      * @maxSize 21
      */
     addOnIds?: string[] | null;
     /**
-     * The selected duration choice ID.
+     * Selected duration choice ID.
      * @format GUID
      */
     durationChoiceId?: string | null;
@@ -440,29 +380,22 @@ interface CursorPaging {
 }
 interface ListMultiServiceAvailabilityTimeSlotsResponse {
     /**
-     * Time slots.
+     * Retrieved time slots.
+     * Sorted by `localStartDate` in ascending order. When multiple slots have the same start time, no specific secondary sorting is guaranteed.
      * @maxSize 1000
      */
     timeSlots?: TimeSlot[];
     /**
-     * Time zone, in IANA time zone format.
-     * Shared for all TimeSlots in response.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate`.
+     * For example, `America/New_York` or `UTC`.
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @minLength 1
      * @maxLength 150
      */
     timeZone?: string | null;
     /**
-     * CursorPagingMetaData.
-     * Contains information about the next page of results.
-     *
-     * By default,
-     * if there are more than 1000 results,
-     * the response will contain a `cursorPagingMetaData` with a cursor to the next page of results.
-     *
-     * <blockquote class="important">
-     * <p><strong>Important:</strong><br/>
-     * <code class="grey-background">count</code> is not supported.</p>
-     * </blockquote>
+     * Paging metadata for the next page of results.
+     * Contains a cursor if there are more than 1000 results.
      */
     cursorPagingMetadata?: CursorPagingMetadata;
 }
@@ -484,51 +417,47 @@ interface Cursors {
 }
 interface GetMultiServiceAvailabilityTimeSlotRequest {
     /**
-     * Services for which the multiService TimeSlots are being returned for.
-     * Each service contains its own resources filters within.
-     *
-     * MinSize: 2.
-     * MaxSize: 8.
+     * Services for which the multi-service time slots are returned.
+     * You can specify resource filters for each service.
      * @minSize 2
      * @maxSize 8
      */
     services: Service[];
     /**
-     * Local start date of the time slot, in ISO-8601 format.
-     * For example, "2024-01-30T13:30:00".
+     * Local start date of the time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
      * @format LOCAL_DATE_TIME
      */
     localStartDate: string;
     /**
-     * Local end date of the time slot, in ISO-8601 format.
-     * For example, "2024-01-30T14:30:00".
+     * Local end date of the time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
      * @format LOCAL_DATE_TIME
      */
     localEndDate: string;
     /**
-     * Time zone, in IANA time zone format.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate` values.
+     * For example, `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @minLength 1
      * @maxLength 150
      */
     timeZone: string | null;
     /**
-     * The location of the time slot.
+     * Location for which the multi-service time slots are returned. If you filter by `{"type": "BUSINESS"}`, you must also specify a location ID. A filter for `location.name` is ignored.
      *
-     * You must provide a specific `locationType`.
-     * If locationType is `BUSINESS`, you __must__ also provide a `locationId`.
-     *
-     * <blockquote class="warning">
-     * <p>Supports filtering by location type, or by location ID.
-     * Other fields like <code class="grey-background">name</code> are ignored.</p>
-     * </blockquote>
+     * Required unless you specify `cursorPaging.cursor`.
      */
     location: Location;
 }
 interface GetMultiServiceAvailabilityTimeSlotResponse {
-    /** Time slot. */
+    /** Retrieved time slot. */
     timeSlot?: TimeSlot;
     /**
-     * The time zone, in IANA time zone format.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate`.
+     * For example, `America/New_York` or `UTC`.
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @minLength 1
      * @maxLength 150
      */
@@ -536,141 +465,92 @@ interface GetMultiServiceAvailabilityTimeSlotResponse {
 }
 interface ListAvailabilityTimeSlotsRequest {
     /**
-     * Service ID for which the time slots are being returned for.
-     * Currently supported only for services of type `APPOINTMENT`.
-     *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Service ID for which to retrieve time slots. You must specify the ID of an appointment-based service.
+     * Required, unless you specify `cursorPaging.cursor`.
      * @format GUID
      */
     serviceId?: string | null;
     /**
-     * Lower boundary for `localStartDate` to include in response, in ISO-8601 format.
-     * For example, "2024-01-30T13:30:00".
-     *
-     * Each returned `TimeSlot` in response has a `localStartDate`
-     * within the provided `fromLocalDate` and `toLocalDate` exclusive.
+     * Lower boundary for `localStartDate` to include in response.
+     * Each returned time slot has a `localStartDate` within the provided `fromLocalDate` and `toLocalDate` exclusive.
+     * Required, unless you specify `cursorPaging.cursor`.
      *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Local start date in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
      * @format LOCAL_DATE_TIME
      */
     fromLocalDate?: string | null;
     /**
-     * Upper boundary for `localStartDate` to include in response, in ISO-8601 format.
-     * For example, "2024-01-30T14:30:00".
+     * Upper boundary for `localStartDate` to include in response.
+     * Each returned time slot has a `localStartDate` within the provided `fromLocalDate` and `toLocalDate` exclusive.
+     * Required, unless you specify `cursorPaging.cursor`.
      *
-     * Each returned `TimeSlot` in response has a `localStartDate`
-     * within the provided `fromLocalDate` and `toLocalDate` exclusive.
-     *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Local end date in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
      * @format LOCAL_DATE_TIME
      */
     toLocalDate?: string | null;
     /**
-     * Time zone, in IANA time zone format.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate`.
+     * For example, `America/New_York` or `UTC`.
      *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @minLength 1
      * @maxLength 150
      */
     timeZone?: string | null;
     /**
      * Locations to include in response.
-     *
-     * By default,
-     * if no locations are provided,
-     * the response contains TimeSlots for all locations where the service is available.
-     *
-     * You can specify locations or location types for which the time slots will be returned for.
-     * If locationType is `BUSINESS`, you __must__ provide a locationId.
-     *
-     * <blockquote class="warning">
-     * <p><strong>warning:</strong><br/>
-     * Supports filtering by location type, or by location ID. </br>
-     * Other fields like <code class="grey-background">name</code> are ignored.</p>
-     * </blockquote>
+     * If not specified, returns time slots for all locations where the service is available.
      * @maxSize 5
      */
     locations?: Location[];
     /**
      * Resources to include in response.
-     *
-     * If specified,
-     * the returned TimeSlots will contain __up__ to 10 available resources out of the provided list.
-     * Otherwise, the returned TimeSlots returns with an empty `AvailableResources`.
+     * If specified, returns up to 10 available resources out of the provided list.
+     * Otherwise, returns time slots with empty `availableResources`.
      * @format GUID
      * @maxSize 135
      * @deprecated
      */
     resourceIds?: string[];
     /**
-     * Resource type ID's to include in response, this is in addition to the requested `resourceIds`.
-     *
-     * If specified in request, the returned TimeSlots will contain __up__ to 10 `AvailableResources` with `ResourceTypeId`
-     * out of those specified, each contains __up__ to 10 available resources of this type.
+     * Resource type IDs to include in the response.
+     * If specified, returns up to 10 `availableResources` with matching `resourceTypeId`.
+     * This controls which resource details are included in the response but doesn't filter the time slots themselves.
      * @format GUID
      * @maxSize 100
      */
     includeResourceTypeIds?: string[];
     /**
-     * Whether the `TimeSlot` is bookable according to the service's booking policies.
-     *
-     * If booking this `TimeSlot` does not violates any of the service's booking policies,
-     * returns as `true`. Otherwise, returns as `false`.
-     *
-     * > __Note:__
-     * > A time slot that doesn't meet the service's bookings policies will be returned with `bookable` = false,
-     * > while a time slot with no available resources will not be returned at all.
+     * Whether the time slot is bookable according to the service's booking policies.
+     * If not specified, returns both bookable and un-bookable time slots.
      */
     bookable?: boolean | null;
     /**
-     * Indicators for service's booking policy violations for booking the `TimeSlot`.
-     *
-     * A bookable time slot must not violate any policy,
-     * therefor, this filter is only relevant when `bookable` filter is false.
-     *
-     * Each nested field is checked on its own. i.e. if `tooEarlyToBook` is defined and `bookOnlineDisabled` is not defined
-     * we return slots for which `tooEarlyToBook` is same as on the request, regardless of `bookOnlineDisabled`.
+     * Indicators for service's booking policy violations.
+     * Only relevant when `bookable` filter is set to `false`. Allows filtering for time slots with specific violation types:
+     * - `tooEarlyToBook`: Returns slots that violate minimum advance booking time.
+     * - `tooLateToBook`: Returns slots that violate maximum advance booking time.
+     * - `bookOnlineDisabled`: Returns slots where online booking is disabled.
      */
     bookingPolicyViolations?: BookingPolicyViolations;
     /**
-     * Maximum number of slots to load for each day. For example, if `timeSlotsPerDay` is set to `3`,
-     * we return at most 3 available TimeSlots for each day within the date range specified in request.
-     *
-     * By default,
-     * if `bookable` filter was not specified,
-     * and a day has both `bookable` and `un-bookable` slots, `bookable` slots are returned first.
-     *
-     * If the number of `bookable` slots is less than the requested `timeSlotsPerDay`,
-     * `un-bookable` slots will be returned according to the specified filters.
+     * Maximum number of slots to return for each day in the specified time range.
+     * If `bookable` filter isn't specified, bookable slots are returned first.
      */
     timeSlotsPerDay?: number | null;
     /**
-     * CursorPaging.
-     *
-     * Enables you to fetch results in smaller, more manageable chunks
-     * by setting a limit on the number of results returned in response.
-     * This is useful in order to enhance efficiency of data retrieval and reduce load on both the client and server.
-     *
-     * If there are more results than the specified limit, the response will contain a `cursorPagingMetaData`
-     * with a cursor pointing to next page of results. In order to fetch the next page of results, you should pass the
-     * returned cursor to the next call as `cursorPaging`.`cursor`.
-     *
-     * For the first call, you should only specify the `limit` for the results page.
-     * For each following call, you should only pass `cursorPaging`.`cursor` with the returned cursor from previous call, and
-     * a `cursorPaging`.`limit`.
-     * No need to specify any additional parameters.
-     *
-     * <blockquote class="important">
-     * <p><strong>Important:</strong><br/>
-     * If you only provide a <code class="grey-background">cursorPaging</code>. <code class="grey-background">cursor</code>,
-     * the response will contain the default size of results which is `1000`.
-     * </p>
-     * </blockquote>
+     * Cursor-based paging configuration.
+     * Enables fetching results in smaller chunks by setting a limit on the number of results.
+     * For consistent pagination behavior, use the same `limit` value throughout a pagination sequence.
+     * When specifying a new `limit` in follow-up requests, the API respects the new value.
      */
     cursorPaging?: CursorPaging;
     /**
-     * resources filter
-     * If specified, only time slots with these resources will be returned.
+     * Resource types to filter time slots.
+     * Only returns time slots that have these specific resource types available.
+     * This filters the time slots themselves, unlike `includeResourceTypeIds` which only controls response details.
      * @maxSize 3
      */
     resourceTypes?: ResourceType[];
@@ -703,13 +583,13 @@ interface CustomerChoices {
 }
 interface ResourceType {
     /**
-     * Resource type ID.
+     * Resource type ID ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resource-types/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resource-types-v2/introduction)).
      * @format GUID
      */
     resourceTypeId?: string | null;
     /**
      * Resource IDs.
-     * The response will contain only slots that have at least one of the specified resources.
+     * Available only if there is at least 1 resource available for the slot.
      * @format GUID
      * @minSize 1
      * @maxSize 135
@@ -718,84 +598,70 @@ interface ResourceType {
 }
 interface ListAvailabilityTimeSlotsResponse {
     /**
-     * Time slots.
+     * Retrieved time slots.
+     * Sorted by `localStartDate` in ascending order. When multiple slots have the same start time, no specific secondary sorting is guaranteed.
      * @maxSize 1000
      */
     timeSlots?: TimeSlot[];
     /**
-     * Time zone, in IANA time zone format.
-     * Shared for all TimeSlots in response.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate`.
+     * For example, `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @minLength 1
      * @maxLength 150
      */
     timeZone?: string | null;
     /**
-     * CursorPagingMetaData.
-     * Contains information about the next page of results.
-     *
-     * By default,
-     * if there are more than 1000 results,
-     * the response will contain a `cursorPagingMetaData` with a cursor to the next page of results.
-     *
-     * <blockquote class="important">
-     * <p><strong>Important:</strong><br/>
-     * <code class="grey-background">count</code> is not supported.</p>
-     * </blockquote>
+     * Paging metadata for the next page of results.
+     * Contains a cursor if there are more than 1000 results.
      */
     cursorPagingMetadata?: CursorPagingMetadata;
 }
 interface GetAvailabilityTimeSlotRequest {
     /**
      * Service ID of the time slot.
-     * Currently supported only for services of type `APPOINTMENT`.
+     * You must specify the ID of an appointment-based service.
      * @format GUID
      */
     serviceId?: string;
     /**
-     * Local start date of the time slot, in ISO-8601 format.
-     * For example, "2024-01-30T13:30:00".
+     * Local start date of the time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
      * @format LOCAL_DATE_TIME
      */
     localStartDate?: string;
     /**
-     * Local end date of the time slot, in ISO-8601 format.
-     * For example, "2024-01-30T14:30:00".
+     * Local end date of the time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
      * @format LOCAL_DATE_TIME
      */
     localEndDate?: string;
     /**
-     * Time zone, in IANA time zone format.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate`.
+     * For example, `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @minLength 1
      * @maxLength 150
      */
     timeZone?: string | null;
     /**
-     * The location of the time slot.
+     * Location to filter time slots by.
      *
-     * You must provide a specific `locationType`.
-     * If locationType is `BUSINESS`, you __must__ also provide a `locationId`.
-     *
-     * <blockquote class="warning">
-     * <p>Supports filtering by location type, or by location ID.
-     * Other fields like <code class="grey-background">name</code> are ignored.</p>
-     * </blockquote>
+     * For business locations, you must specify a location ID.
+     * When specifying a location ID, all other location field filters are ignored.
      */
     location?: Location;
     /**
-     * Resources to include in response.
-     *
-     * If specified,
-     * the returned `TimeSlot` contains only the available resources out of provided list.
-     * Otherwise, the returned `TimeSlot` returned with all possible `AvailableResources`.
+     * IDs of the resources ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-v2/introduction)) to check availability for.
+     * If omitted, time slots are returned if there's at least 1 available resource.
      * @format GUID
      * @maxSize 135
      */
     resourceIds?: string[];
     /**
-     * Resource type IDs to include in response, this is in addition to the requested `resourceIds`.
-     *
-     * If specified in request, the returned `TimeSlot` contains only the `AvailableResources` with `ResourceTypeId`
-     * out of those specified, each contains all the available resources of this type.
+     * IDs of the resource types ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resource-types/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resource-types-v2/introduction)) to check availability for.
      * @format GUID
      * @maxSize 100
      */
@@ -803,23 +669,26 @@ interface GetAvailabilityTimeSlotRequest {
 }
 interface GetAvailabilityTimeSlotRequestCustomerChoices {
     /**
-     * The selected add-ons IDs.
+     * Selected add-on IDs.
      * Max: Derived from max amount of Add-On groups * max amount of Add-Ons per group.
      * @format GUID
      * @maxSize 21
      */
     addOnIds?: string[] | null;
     /**
-     * The selected duration choice ID.
+     * Selected duration choice ID.
      * @format GUID
      */
     durationChoiceId?: string | null;
 }
 interface GetAvailabilityTimeSlotResponse {
-    /** Time slot. */
+    /** Retrieved time slot. */
     timeSlot?: TimeSlot;
     /**
-     * Time zone, in IANA time zone format.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate`.
+     * For example, `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @minLength 1
      * @maxLength 150
      */
@@ -827,87 +696,104 @@ interface GetAvailabilityTimeSlotResponse {
 }
 interface ListEventTimeSlotsRequest {
     /**
-     * Local start date for which event time slots are returned, in ISO-8601 format.
-     * E.g., "2024-01-30T13:30:00".
-     * Required, unless `cursorPaging` is provided.
+     * Lower boundary for `localStartDate` to include in the response.
+     * Each returned time slot has a `localStartDate` between `fromLocalDate` and `toLocalDate.
+     * Required unless you specify `cursorPaging.cursor`.
+     *
+     * Local start date in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
      * @format LOCAL_DATE_TIME
      */
     fromLocalDate?: string | null;
     /**
-     * Local end date for which event time slots are returned, in ISO-8601 format.
-     * E.g., "2024-01-30T13:30:00".
-     * Required, unless `cursorPaging` is provided.
+     * Upper boundary for `localStartDate` to include in the response.
+     * Each returned time slot has a `localStartDate` between `fromLocalDate` and `toLocalDate`.
+     * Required unless you specify `cursorPaging.cursor`.
+     *
+     * Local end date in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
      * @format LOCAL_DATE_TIME
      */
     toLocalDate?: string | null;
     /**
-     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
-     * For example, `America/New_York`.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate` values.
+     * For example, `America/New_York` or `UTC`.
      *
-     * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @maxLength 100
      */
     timeZone?: string | null;
     /**
-     * Optional service IDs to filter by.
+     * Optional service IDs to filter the response.
      * If not provided, time slots for all services are returned.
      * @format GUID
      * @maxSize 100
      */
     serviceIds?: string[] | null;
     /**
-     * Whether to filter bookable slots only.
-     * A bookable slot is a slot that has remaining capacity and also satisfies the booking policy.
-     * Default true: bookable and non-bookable slots are returned.
+     * Whether to include time slots that aren't bookable according to the service's booking policy or that are fully booked.
+     * - `true`: Both bookable and non-bookable time slots are returned.
+     * - `false`: Only bookable time slots are returned.
+     *
+     * Default: `true`
      */
     includeNonBookable?: boolean | null;
     /**
-     * Filter event time slots by the minimum bookable capacity.
+     * Minimum bookable capacity.
+     * Use to filter out sessions that can't accommodate the desired party size.
      * @min 1
      */
     minBookableCapacity?: number | null;
     /**
-     * Optional filter to apply to the events. E.g., resource, location, etc.
-     * See the Events API [Supported Filters and Sorting](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/supported-filters-and-sorting) for more information.
+     * Optional filter to apply to the events, for example resource or location.
+     * See the [Events API Supported Filters and Sorting article](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/supported-filters-and-sorting) for a complete list of filters.
      */
     eventFilter?: Record<string, any> | null;
     /**
-     * The maximum number of time slots to return for each day.
-     * For example, if `maxSlotsPerDay` is set to `1`, at most 1 available slot is returned for each day.
-     * When a day has both bookable and non-bookable slots, bookable slots are returned first.
-     * If `maxSlotsPerDay` is provided, `toLocalDate` must also be provided and must be at most 1 month after `fromLocalDate`.
+     * Maximum number of slots to return for each day in the specified time range.
+     * If both bookable and non-bookable slots exist on the same day, bookable slots are returned first.
+     *
+     * When you specify `maxSlotsPerDay`, you must also specify `toLocalDate`, and it must be no more than 1 month after `fromLocalDate`.
      * @min 1
      * @max 1000
      */
     maxSlotsPerDay?: number | null;
-    /** Cursor to retrieve the next page of results. */
+    /**
+     * Cursor-based paging configuration.
+     * Enables fetching results in smaller chunks by setting a limit on the number of returned items.
+     */
     cursorPaging?: CursorPaging;
 }
 interface ListEventTimeSlotsResponse {
     /** Retrieved time slots matching the specified filters. */
     timeSlots?: TimeSlot[];
     /**
-     * The time slots time zone.
-     * Either provided explicitly or default to the business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate` values.
+     * For example, `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @minLength 1
      * @maxLength 150
      */
     timeZone?: string | null;
-    /** Paging metadata. */
+    /**
+     * Paging metadata for the next page of results.
+     * Contains a cursor if more data is available.
+     */
     pagingMetadata?: CursorPagingMetadata;
 }
 interface GetEventTimeSlotRequest {
     /**
-     * The event ID.
+     * Event ID.
      * @minLength 36
      * @maxLength 250
      */
     eventId?: string | null;
     /**
-     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database).
-     * For example, `America/New_York`.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate` values.
+     * For example, `America/New_York` or `UTC`.
      *
-     * Default: `timeZone` specified in the business [site properties](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties).
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @maxLength 100
      */
     timeZone?: string | null;
@@ -916,8 +802,10 @@ interface GetEventTimeSlotResponse {
     /** The time slot. */
     timeSlot?: TimeSlot;
     /**
-     * The time slot time zone.
-     * Either provided explicitly or default to the business time zone.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate` values.
+     * For example, `America/New_York` or `UTC`.
+     *
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @minLength 1
      * @maxLength 150
      */
@@ -963,83 +851,28 @@ type GetMultiServiceAvailabilityTimeSlotApplicationErrors = {
 };
 type TimeSlotNonNullablePaths = `location.locationType` | `availableResources` | `nestedTimeSlots` | `nestedTimeSlots.${number}.serviceId` | `nestedTimeSlots.${number}.localStartDate` | `nestedTimeSlots.${number}.localEndDate`;
 /**
- * Retrieves a list of multiService `TimeSlot`s that match the provided filters.
- *
- * <blockquote class="important">
- * <p><strong>Important:</strong><br/>
- * Currently supported only for services of type <code class="grey-background">APPOINTMENT</code>.</p>
- * </blockquote>
- *
- * The request body __must__ include either:
- * + All of the following filters:  `service`.`serviceId`, `fromLocalDate`, `toLocalDate`, `location`, and `timeZone`. You may add additional filters as you wish.
- * + A `cursorPaging` with a valid `cursor` from previous response.
- *
- *
- * Each [TimeSlot](https://bo.wix.com/wix-docs/rest/all-apis/wix-service-availability/availability-time-slots/time-slot-object) in response
- * represents the availability of the given sequence of services in a specific order, location, and within a given range of time.
- *
- * Each `TimeSlot`.`NestedTimeSlot` represents a single service from the given list. The order of the `NestedTimeSlots` is the same as the order
- * of the given services in request.
- * The first `NestedTimeSlot` has `localStartDate` within the given `fromLocalDate` and `toLocalDate` exclusive,
- * and each following `NestedTimeSlot` has a `localStartDate` that equals to the previous `NestedTimeSlot`'s `localEndDate`.
+ * Retrieves a list of multi-service time slots that match the provided filters.
  *
- * By default,
- * the response contains at most 1000 results.
- * If there are more than 1000 results, we return a `cursorPagingMetadata` with
- * a cursor for the next page of results, regardless of whether a `cursorPaging`
- * was provided in request.
  *
- * > __Notes:__
- * >  + All nested time slots share the same location.
- * >  + You can pass up to 8 services in request.
+ * ## Required filters
  *
- * ### AvailableResources in response:
- * The `TimeSlot`.`NestedTimeSlot`'s `AvailableResources` contains information about the resources that are available to provide the service
- * within the `NestedTimeSlot` range of time. Each `AvailableResources` contains information about available resources of the same type.
+ * You must specify one of:
+ * - `services.serviceId`, `fromLocalDate`, `toLocalDate`, `location`, and `timeZone` (additional filters are optional).
+ * - `cursorPaging.cursor` returned from a previous response.
  *
- * <blockquote class="important">
- * <p><strong>Important:</strong><br/>
- * By default,
- * if you don't specify <code class="grey-background">service</code>.<code class="grey-background">includeResourceTypeIds</code>
- * or  <code class="grey-background">service</code>.<code class="grey-background">resourceIds</code> filters in request,
- * we return TimeSlots with <code class="grey-background">NestedTimeSlot</code>s with an empty <code class="grey-background">AvailableResources</code>.
- * <br/><strong>Note:</strong><br/> Not specifying resources filters can be handy in case you want to avoid large response in flows that only
- * interested of whether the time slots are available. [Finding the next available slot within the next 3 months](https://bo.wix.com/wix-docs/rest/all-apis/service-availability/multi-service-availability-time-slots/sample-flows?localViewerId=inbari#all-apis_service-availability_multi-service-availability-time-slots_sample-flows_find-the-first-date-within-the-next-3-months-that-all-selected-services-are-available-for)
- * is an example for such flow.
- * </p>
- * </blockquote>
+ * Each returned `timeSlot` acts as a container spanning the entire service sequence, with nested time slots providing individual service details.
  *
+ * ## Defaults
  *
- * If you wish to get a list of available resources for a `TimeSlot`.`NestedTimeSlot` you should either:
- * + provide `service`.`resourceIds` in request.
- * + provide `service`.`includeResourceTypeIds` in request.
+ * - Results are sorted by `localStartDate` in ascending order.
+ * - `cursorPaging.limit` is `1000`.
+ * - The response contains both bookable and non-bookable slots.
  *
- * __Notes:__
- * + In both cases the returned `TimeSlot`.`NestedTimeSlot` contains  __up__ to 10 `AvailableResources` that match the provided filters. Each `AvailableResources` contains __up__ to 10 available `resources` of the same type that match the provided filters.
- * + If an `AvailableResources` has more available resources which are not listed within it, we return `AvailableResources`.`hasMoreAvailableResources` as true.
- * + If you wish to get the full available resources list for all `NestedTimeSlot` of a specific `TimeSlot`, you should call [GetMultiServiceAvailabilityTimeSlot](https://bo.wix.com/wix-docs/rest/all-apis/wix-service-availability/multi-service-availability-time-slots/get-multi-service-availability-time-slot).
+ * ## Service type limitations
  *
+ * Only appointment-type services are supported.
  *
- * ### Availability VS Bookability
- * An `available` time slot is not necessarily `bookable`.
- * The `bookable` field of a `TimeSlot` indicates whether the customer can book all of the of the services within the given time slot,
- * at a specific period of time.
- * Read more about [Availability VS Bookability](https://bo.wix.com/wix-docs/rest/all-apis/wix-service-availability/multi-service-availability-time-slots/introduction#all-apis_wix-service-availability_multi-service-availability-time-slots_introduction_availability-vs-bookability).
- *
- * By default,
- * + The response does not contains `unavailable` TimeSlots.For example, if there are no available resources to provide one of the services from `2024-01-30T14:30:00` to `2024-01-30T15:30:00`, we don't return TimeSlots with `NestedTimeSlot`.`localStartDate` within this range for this service.
- * + The response contains both `bookable` and `un-bookable` TimeSlots.For example, if one of the services has a booking policy which enforces booking the service up to 10 minutes before the session starts, we return TimeSlots with the violating `NestedTimeSlot`.`localStartDate`, with `bookable` as `false`. If you want to list only __bookable__ TimeSlots you should pass `bookable` as `true`.
- * + If booking one of the `NestedTimeSlot`s violates one of the corresponding service's booking policies, the `TimeSlot` returns with `bookable` as false. There is no indication which service's policy was violated.
- *
- * <blockquote class="important">
- * <p><strong>Important:</strong>
- * Because of DST, there are edge cases where certain times either do not exist or exist twice for a local time zone.
- * Read more about <a href="https://bo.wix.com/wix-docs/rest/all-apis/wix-service-availability/multi-service-availability-time-slots/introduction#all-apis_wix-service-availability_multi-service-availability-time-slots_introduction_daylight-saving-time-dst-handling">DST Handling</a></p>
- * </blockquote>
- *
- * ### ListAvailabilityTimeSlots runs with the following defaults:
- * + `localStartDate` is sorted in `ASC` order.
- * + `cursorPaging`.`limit` is `1000`.
+ * To retrieve appointment availability for a single service, call List Availability Time Slots ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/availability/availability-time-slots/list-availability-time-slots) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/availability/availability-time-slots/list-availability-time-slots)).
  * @public
  * @documentationMaturity preview
  * @permissionId BOOKINGS.AVAILABILITY_READ_MULTI_SERVICE_TIME_SLOTS
@@ -1054,170 +887,101 @@ declare function listMultiServiceAvailabilityTimeSlots(options?: ListMultiServic
 }>;
 interface ListMultiServiceAvailabilityTimeSlotsOptions {
     /**
-     * Services for which the multiService time slots are being returned for.
-     * Each service contains its own resources filters within.
-     *
-     * MinSize: `2`.
-     * MaxSize: `8`.
+     * Services for which the multi-service time slots are returned.
+     * Each service can include its own resource filters.
      *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Required unless you specify `cursorPaging.cursor`.
      * @maxSize 8
      */
     services?: Service[];
     /**
-     * Lower boundary for `localStartDate` to include in response, in ISO-8601 format.
-     * For example, "2024-01-30T13:30:00".
+     * Lower boundary for `localStartDate` in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
+     * Each returned time slot has a `localStartDate` between `fromLocalDate` and `toLocalDate`.
      *
-     * Each returned `TimeSlot` in response has a `localStartDate`
-     * within the provided `fromLocalDate` and `toLocalDate` exclusive.
-     *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Required unless you specify `cursorPaging.cursor`.
      * @format LOCAL_DATE_TIME
      */
     fromLocalDate?: string | null;
     /**
-     * Upper boundary for `localStartDate` to include in response, in ISO-8601 format.
-     * For example, "2024-01-30T14:30:00".
-     *
-     * Each returned `TimeSlot` in response has a `localStartDate`
-     * within the provided `fromLocalDate` and `toLocalDate` exclusive.
+     * Upper boundary for `localToDate` in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+     * For example, `2026-01-30T13:30:00`.
+     * Each returned time slot has a `localEndDate` between `fromLocalDate` and `toLocalDate`.
      *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Required unless you specify `cursorPaging.cursor`.
      * @format LOCAL_DATE_TIME
      */
     toLocalDate?: string | null;
     /**
-     * Time zone, in IANA time zone format.
+     * Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate` values. For example, `America/New_York` or `UTC`.
      *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Required unless you specify `cursorPaging.cursor`.
+     *
+     * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
      * @minLength 1
      * @maxLength 150
      */
     timeZone?: string | null;
     /**
-     * Location for which the multiService TimeSlots are being returned for.
-     *
-     * You can specify location or location type for which the TimeSlots will be returned for.
-     * If locationType is `BUSINESS`, you __must__ provide a locationId.
+     * Location for which the multi-service time slots are returned. If you filter by `{"type": "BUSINESS"}`, you must also specify a location ID. A filter for `location.name` is ignored.
      *
-     * <blockquote class="warning">
-     * <p><strong>warning:</strong><br/>
-     * Supports filtering by location type, or by location ID. </br>
-     * Other fields like <code class="grey-background">name</code> are ignored.</p>
-     * </blockquote>
-     *
-     * Required, unless `cursorPaging`.`cursor` is provided.
+     * Required unless you specify `cursorPaging.cursor`.
      */
     location?: Location;
     /**
-     * Whether the `TimeSlot` is bookable according to all of the services booking policies.
-     *
-     * If booking any of the `TimeSlot`.`NestedTimeSlot`s violates any of its services bookings policies,
-     * returns as `false`. Otherwise, returns as `true`.
-     *
-     * > __Note:__
-     * > A `TimeSlot` with a `NestedTimeSlot` that doesn't meet its service's bookings policies will be returned with `bookable` = false,
-     * > while a `TimeSlot` with no available resources will not be returned at all.
+     * Whether the time slot is bookable according to all services' booking policies.
+     * If not specified, returns both bookable and non-bookable time slots.
      */
     bookable?: boolean | null;
     /**
-     * Indicators for service's booking policy violations for booking the `TimeSlot`.
-     *
-     * A bookable time slot must not violate any policy,
-     * therefor, this filter is only relevant when `bookable` filter is false.
-     *
-     * Each nested field is checked on all `NestedTimeSlot`s. For example, if only one of the `NestedTimeSlot`'s
-     * has a service with `tooEarlyToBook` same as in the request, we return the `TimeSlot` regardless of whether
-     * the other `NestedTimeSlots` has the same `tooEarlyToBook` as in request.
-     *
-     * Each nested field is checked on its own. For example, if `tooEarlyToBook` is defined and `bookOnlineDisabled` is not defined
-     * we return slots for which `tooEarlyToBook` is same as on the request, regardless of `bookOnlineDisabled`.
+     * Indicators for service's booking policy violations.
+     * Only relevant when `bookable` filter is false.
      */
     bookingPolicyViolations?: BookingPolicyViolations;
     /**
-     * Maximum number of slots to load for each day. For example, if `timeSlotsPerDay` is set to `3`,
-     * we return at most 3 available TimeSlots for each day within the date range specified in request.
-     *
-     * By default,
-     * if `bookable` filter was not specified,
-     * and a day has both `bookable` and `un-bookable` slots, `bookable` slots are returned first.
-     *
-     * If the number of `bookable` slots is less than the requested `timeSlotsPerDay`,
-     * `un-bookable` slots will be returned according to the specified filters.
+     * Maximum number of slots to return for each day in the specified time range.
+     * If `bookable` filter isn't specified, bookable slots are returned first.
      */
     timeSlotsPerDay?: number | null;
     /**
-     * CursorPaging.
-     *
-     * Enables you to fetch TimeSlots in smaller, more manageable chunks
-     * by setting a limit on the number of results returned in response.
-     * This is useful in order to enhance efficiency of data retrieval and reduce load on both the client and server.
-     *
-     * If there are more results than the specified limit, the response will contain a `cursorPagingMetaData`
-     * with a cursor pointing to next page of results. In order to fetch the next page of results, you should pass the
-     * returned cursor to the next call as `cursorPaging`.`cursor`.
-     *
-     * For the first call, you should only specify the `limit` for the results page.
-     * For each following call, you should only pass the previous returned cursor as `cursorPaging`.`cursor`
-     * the `cursorPaging`.`limit`. You may pass a different `limit`.
-     * No need to specify any additional parameters.
-     *
-     * <blockquote class="important">
-     * <p><strong>Important:</strong><br/>
-     * If you only provide a <code class="grey-background">cursorPaging</code>. <code class="grey-background">cursor</code>,
-     * the response will contain the default size of results which is `1000`.
-     * </p>
-     * </blockquote>
+     * Cursor-based paging configuration.
+     * Enables fetching results in smaller chunks by setting a limit on the number of results.
+     * For consistent pagination behavior, use the same `limit` value throughout a pagination sequence.
+     * When specifying a new `limit` in follow-up requests, the API respects the new value.
      */
     cursorPaging?: CursorPaging;
 }
 /**
- * Retrieves an available multiService `TimeSlot` that match the provided filters.
+ * Retrieves a multi-service time slot that matches the specified filters.
+ *
  *
- * Throws `SlotNotFound` if there is no such available time slot.
+ * Call this method after finding a suitable slot with List Multi-Service Availability Time Slots to obtain full capacity, resource, and booking-policy details.
  *
- * <blockquote class="important">
- * <p><strong>Important:</strong><br/>
- * Currently supported only for services of type <code class="grey-background">APPOINTMENT</code>.</p>
- * </blockquote>
+ * The returned time slot acts as a container spanning the entire service sequence, with nested time slots providing detailed information for each individual service.
  *
- * By default,
- * if you don't provide a `service`.`includeResourceTypeIds` or `service`.`resourceIds` in request,
- * we return for each `TimeSlot`.`NestedTimeSlot` all `AvailableResources` with all `AvailableResources`.`resources` which are available to provide
- * the corresponding service within the time slot.
+ * ## Defaults
  *
- * If you specify `service`.`includeResourceTypeIds` or `service`.`resourceIds` in request,
- * the returned `TimeSlot`.`NestedTimeSlot` for this service will contain only `AvailableResources` with at least one available resource
- * which match the given resources filters,
- * each contains all available resources out of those requested.
+ * - Returns all available resources unless you filter by `services.resourceIds` or `services.includeResourceTypeIds`.
+ * - Includes full booking-status and capacity details.
  *
- * + Notes:
- * + All nested time slots share the same location.
- * + You can pass up to 8 services.
+ * ## Service type limitations
  *
- * <blockquote class="tip">
- * <p><strong>Tip:</strong><br/>
- * Use this API in order to get the availability of a specific <code class="grey-background">TimeSlot</code> out of those returned from  <code class="grey-background">ListMultiServiceAvailabilityTimeSlots</code> API.</p>
- * </blockquote>
- * @param services - Services for which the multiService TimeSlots are being returned for.
- * Each service contains its own resources filters within.
+ * Only appointment-type services are supported.
  *
- * MinSize: 2.
- * MaxSize: 8.
- * @param localStartDate - Local start date of the time slot, in ISO-8601 format.
- * For example, "2024-01-30T13:30:00".
- * @param localEndDate - Local end date of the time slot, in ISO-8601 format.
- * For example, "2024-01-30T14:30:00".
- * @param timeZone - Time zone, in IANA time zone format.
- * @param location - The location of the time slot.
+ * To retrieve appointment availability for a single service, call List Availability Time Slots ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/availability/availability-time-slots/list-availability-time-slots) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/availability/availability-time-slots/list-availability-time-slots)).
+ * @param services - Services for which the multi-service time slots are returned.
+ * You can specify resource filters for each service.
+ * @param localStartDate - Local start date of the time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+ * For example, `2026-01-30T13:30:00`.
+ * @param localEndDate - Local end date of the time slot in `YYYY-MM-DDThh:mm:ss` [ISO-8601 format](https://en.wikipedia.org/wiki/ISO_8601).
+ * For example, `2026-01-30T13:30:00`.
+ * @param timeZone - Time zone in [IANA tz database format](https://en.wikipedia.org/wiki/Tz_database) for adjusting `fromLocalDate` and `toLocalDate` values.
+ * For example, `America/New_York` or `UTC`.
  *
- * You must provide a specific `locationType`.
- * If locationType is `BUSINESS`, you __must__ also provide a `locationId`.
+ * Default: `timeZone` specified in the business site properties ([SDK](https://dev.wix.com/docs/sdk/backend-modules/site-properties/properties/get-site-properties) | [REST](https://dev.wix.com/docs/rest/business-management/site-properties/properties/get-site-properties)).
+ * @param location - Location for which the multi-service time slots are returned. If you filter by `{"type": "BUSINESS"}`, you must also specify a location ID. A filter for `location.name` is ignored.
  *
- * <blockquote class="warning">
- * <p>Supports filtering by location type, or by location ID.
- * Other fields like <code class="grey-background">name</code> are ignored.</p>
- * </blockquote>
+ * Required unless you specify `cursorPaging.cursor`.
  * @public
  * @documentationMaturity preview
  * @requiredField localEndDate