@wix/bookings 1.0.297 → 1.0.299

package/build/es/src/bookings-availability-v2-time-slot.universal.d.ts

@@ -0,0 +1,1415 @@
+export declare const __debug: {
+    verboseLogging: {
+        on: () => boolean;
+        off: () => boolean;
+    };
+};
+/**
+ * The `TimeSlot` object represents the availability information
+ * for an `Appointment` service's specific slot, including:
+ *
+ * 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.
+ */
+export interface TimeSlot {
+    /**
+     * Service ID.
+     *
+     * > Not returned from `MultiServiceAvailabilityTimeSlots` API calls.
+     * > Instead, each nested time slot has its own serviceId.
+     */
+    serviceId?: string | null;
+    /**
+     * Local start date of the time slot in ISO-8601 format.
+     * For example, "2024-01-30T13:30:00".
+     *
+     * > When returned from `MultiServiceAvailabilityTimeSlots` API calls,
+     * > represents the earliest `localStartDate` of the `TimeSlot`'s nested time slots.
+     */
+    localStartDate?: string | null;
+    /**
+     * Local end date of the time slot in ISO-8601 format.
+     * For example, "2024-01-30T14:30:00".
+     *
+     * > When returned from `MultiServiceAvailabilityTimeSlots` API calls,
+     * > represents the latest `localEndDate` of the `TimeSlot`'s nested time slots.
+     */
+    localEndDate?: string | null;
+    /**
+     * Whether the slot is bookable according to the service's booking policies.
+     *
+     * If booking this time slot does not violates any of the service's booking policies,
+     * the returned value is `true`. Otherwise, returns `false`.
+     *
+     * > When returned from `MultiServiceAvailabilityTimeSlots` API calls,
+     * > + `bookable` is `false` if at least one of the provided services is not bookable within the time slot.
+     * > + `bookable` is `true` if all provided services are bookable within the time slot.
+     */
+    bookable?: boolean | null;
+    /**
+     * The geographic location of the slot.
+     *
+     * > When returned from `MultiServiceAvailabilityTimeSlots` API calls,
+     * > the geographic location of all nested time slots of the `TimeSlot`.
+     */
+    location?: Location;
+    /**
+     * Total number of spots for the slot.
+     *
+     * > When returned from `MultiServiceAvailabilityTimeSlots` API calls,
+     * > `totalCapacity` is always 1, regardless the number of requested services.
+     */
+    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.
+     *
+     * > When returned from `MultiServiceAvailabilityTimeSlots` API calls,
+     * > `remainingCapacity` is 1 if all requested services has `remainingCapacity` >= 1.
+     * > `remainingCapacity` is 0, if there is at least one requested service with `remainingCapacity` < 1.
+     */
+    remainingCapacity?: number | null;
+    /**
+     * > When returned from `ListMultiServiceAvailabilityTimeSlots`,
+     * > indicates that at least one of the nested time slots does not meet with at least one of the service's booking policies.
+     * > There is no indication which of the requested services violates a booking policy.
+     */
+    bookingPolicyViolations?: BookingPolicyViolations;
+    /**
+     * List of `AvailableResources` for the time slot.
+     * Each `AvailableResources` contains information about available resources of the same type.
+     *
+     * > Not returned from `MultiServiceAvailabilityTimeSlots` API calls.
+     * > Instead, each nested time slot has its own available resources.
+     */
+    availableResources?: AvailableResources[];
+    /**
+     * > Nested time slots.
+     * > Returned only from `MultiServiceAvailabilityTimeSlots` API calls.
+     */
+    nestedTimeSlots?: NestedTimeSlot[];
+}
+export interface Location {
+    /** Business Location ID. Present only if the location is a business location. */
+    _id?: string | null;
+    /** The location name. */
+    name?: string | null;
+    /** A string representation for the full address of the location. */
+    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.
+     */
+    locationType?: LocationType;
+}
+export 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. */
+    CUSTOM = "CUSTOM",
+    /** The location can be determined by the customer and is not set up beforehand. */
+    CUSTOMER = "CUSTOMER"
+}
+/** relevant for event based slots, and not for availability based slots */
+export interface EventInfo {
+}
+export interface WaitingList {
+    /** Total number of spots in this wait list. */
+    totalCapacity?: number | null;
+    /**
+     * Number of remaining spots for this wait list.
+     * For example, a Yoga event with 10 waitList spots and 3 registered
+     * on the waitList has 10 `total_capacity` and 7 `remaining_capacity`.
+     */
+    remainingCapacity?: number | null;
+}
+export interface BookingPolicyViolations {
+    /** Bookings policy violation. Too early to book this slot. */
+    tooEarlyToBook?: boolean | null;
+    /** Bookings policy violation. Too late to book this slot. */
+    tooLateToBook?: boolean | null;
+    /** Bookings policy violation. Online booking is disabled for the `TimeSlot` service. */
+    bookOnlineDisabled?: boolean | null;
+}
+export interface AvailableResources {
+    /** Resource type ID. */
+    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.
+     *
+     *
+     * > + 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.
+     *
+     * > + 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.
+     */
+    resources?: Resource[];
+    /**
+     * Whether there are more available resources for the slot that are not listed in `resources` due to size limitations.
+     * @readonly
+     */
+    hasMoreAvailableResources?: boolean | null;
+}
+export interface Resource {
+    /** Resource ID. */
+    _id?: string;
+    /** Resource name. */
+    name?: string | null;
+}
+export interface NestedTimeSlot {
+    /** Service ID of the nested time slot. */
+    serviceId?: string;
+    /**
+     * Local start date of the nested time slot in ISO-8601 format.
+     * For example, "2024-01-30T13:30:00".
+     */
+    localStartDate?: string;
+    /**
+     * Local end date of the nested time slot in ISO-8601 format.
+     * For example, "2024-01-30T14:30:00".
+     */
+    localEndDate?: string;
+    /**
+     * List of `AvailableResources` for the nested time slot.
+     * Each `AvailableResources` contains information about available resources of the same type.
+     */
+    availableResources?: AvailableResources[];
+}
+export interface CalculateEventBasedAvailabilityRequest {
+    serviceIds?: string[];
+    from?: string;
+    to?: string;
+    timeZone?: string;
+    /**
+     * TODO good definition of what bookable means https://github.com/wix-private/scheduler/pull/18267/files?file-filters%5B%5D=.proto&show-viewed-files=true#r1199809006
+     * TODO: Locks are not taken into account. // Class is not supported yet. (relevant only for classes with waiting list)
+     * Aliza's suggestion to consider locks in bookable
+     */
+    bookable?: boolean | null;
+    /** support filtering by location type, or by locationId. Other fields like `name` are ignored */
+    location?: Location[];
+    resourceIds?: string[];
+    /** if not empty, return slots with openSpots >= X */
+    openSpots?: number | null;
+    /**
+     * each nested field is checked on its own. i.e. if `too_early_to_book` is defined and `too_late_to_book` is not defined
+     * we will return slots for which `too_early_to_book` is same as on the request, regardless of `too_late_to_book`.
+     */
+    bookingPolicyViolations?: BookingPolicyViolations;
+    /**
+     * Maximum number of slots to load for each date. For example, if `slots_per_day` is set to `3`,
+     * at most 3 available slots are returned for each day in the date range specified in the query's
+     * `filter`.
+     *
+     * When a day has both bookable and non-bookable slots, bookable slots are returned first.
+     * Non-bookable slots are returned according to the specified filters, after all
+     * bookable slots are already included.
+     */
+    slotsPerDay?: number | null;
+    cursorPaging?: CursorPaging;
+}
+export interface CursorPaging {
+    /** Number of items to load. */
+    limit?: number | null;
+    /**
+     * Pointer to the next or previous page in the list of results.
+     *
+     * You can get the relevant cursor token
+     * from the `pagingMetadata` object in the previous call's response.
+     * Not relevant for the first request.
+     */
+    cursor?: string | null;
+}
+export interface CalculateEventBasedAvailabilityResponse {
+    slots?: TimeSlot[];
+    cursorPagingMetadata?: CursorPagingMetadata;
+}
+export interface CursorPagingMetadata {
+    /** Number of items returned in the response. */
+    count?: number | null;
+    /** Offset that was requested. */
+    cursors?: Cursors;
+    /**
+     * Indicates if there are more results after the current page.
+     * If `true`, another page of results can be retrieved.
+     * If `false`, this is the last page.
+     */
+    hasNext?: boolean | null;
+}
+export interface Cursors {
+    /** Cursor pointing to next page in the list of results. */
+    next?: string | null;
+    /** Cursor pointing to previous page in the list of results. */
+    prev?: string | null;
+}
+export interface ListEventTimeSlotsRequest {
+    /** The services for which the time slots are being returned. */
+    serviceIds?: string[] | null;
+    /**
+     * 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.
+     */
+    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.
+     */
+    toLocalDate?: string | null;
+    /**
+     * The time zone, in IANA time zone format.
+     * Default is the Wix Business time zone.
+     */
+    timeZone?: string | null;
+    /** TODO good definition of what bookable means https://github.com/wix-private/scheduler/pull/18267/files?file-filters%5B%5D=.proto&show-viewed-files=true#r1199809006 */
+    bookable?: boolean | null;
+    /** support filtering by location type, or by locationId. Other fields like `name` are ignored */
+    location?: Location[];
+    /** TODO: maxsize && do we need include_resource_type_id here? also is the behavior is the same as availabilityTimeSlots, we won't return resources by default? */
+    resourceIds?: string[] | null;
+    /** if not empty, return slots with remainingCapacity >= X */
+    remainingCapacity?: number | null;
+    /**
+     * each nested field is checked on its own. i.e. if `too_early_to_book` is defined and `too_late_to_book` is not defined
+     * we will return slots for which `too_early_to_book` is same as on the request, regardless of `too_late_to_book`.
+     */
+    bookingPolicyViolations?: BookingPolicyViolations;
+    /**
+     * Maximum number of slots to load for each date. For example, if `slots_per_day` is set to `3`,
+     * at most 3 available slots are returned for each day in the date range specified in the query's
+     * `filter`.
+     *
+     * When a day has both bookable and non-bookable slots, bookable slots are returned first.
+     * Non-bookable slots are returned according to the specified filters, after all
+     * bookable slots are already included.
+     */
+    timeSlotsPerDay?: number | null;
+    cursorPaging?: CursorPaging;
+}
+export interface ListEventTimeSlotsResponse {
+    /** TODO: maxsize */
+    timeSlots?: TimeSlot[];
+    /** The time zone, in IANA time zone format. */
+    timeZone?: string | null;
+    cursorPagingMetadata?: CursorPagingMetadata;
+}
+export interface ListMultiServiceAvailabilityTimeSlotsRequest {
+    /**
+     * Services for which the multiService time slots are being returned for.
+     * Each service contains its own resources filters within.
+     *
+     * MinSize: 2.
+     * MaxSize: 8.
+     */
+    services?: Service[];
+    /**
+     * Lower boundary for `localStartDate` to include in response, in ISO-8601 format.
+     * For example, "2024-01-30T13:30:00".
+     * Required, unless `cursorPaging`.`cursor` is provided.
+     * > __Note:__: Each returned `TimeSlot` in response has a `localStartDate`
+     * > within the provided `fromLocalDate` and `toLocalDate` exclusive.
+     */
+    fromLocalDate?: string | null;
+    /**
+     * Upper boundary for `localStartDate` to include in response, in ISO-8601 format.
+     * For example, "2024-01-30T14:30:00".
+     * Required, unless `cursorPaging`.`cursor` is provided.
+     * > __Note:__: Each returned `TimeSlot` in response has a `localStartDate`
+     * > within the provided `fromLocalDate` and `toLocalDate` exclusive.
+     */
+    toLocalDate?: string | null;
+    /**
+     * Time zone, in IANA time zone format.
+     * Required, unless `cursorPaging`.`cursor` is provided.
+     */
+    timeZone?: string | null;
+    /**
+     * Location for which the multiService time slots are being returned for.
+     *
+     * You can specify location or location type for which the time slots will be returned for.
+     * > __Note:__ Supports filtering by location type, or by locationId. Other fields like `name` are ignored.
+     * > If locationType is `BUSINESS`, you __must__ provide a locationId.
+     */
+    location?: Location;
+    /**
+     * Whether the `TimeSlot` is bookable according 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.
+     */
+    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`.
+     */
+    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 `TimeSlot`'s 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.
+     */
+    timeSlotsPerDay?: number | null;
+    /**
+     * CursorPaging.
+     *
+     * Enables you to fetch `TimeSlot`'s in smaller, more manageable chunks
+     * by setting a limit on the number of `TimeSlots` 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.
+     *
+     * __TODO: This is only describes the current behavior, should be fixed__
+     * <blockquote class="important">
+     * <p><strong>Important:</strong><br/>
+     * If you only provide a `cursorPaging`.`cursor`,
+     * the response will contain the default size of results = 1000.
+     * </p>
+     * </blockquote>
+     *
+     * cursorPaging.limit:
+     * Default: 1000
+     * Max: 1000
+     */
+    cursorPaging?: CommonCursorPaging;
+}
+export interface Service {
+    /** Service ID. */
+    serviceId?: string;
+    /** Resources to include in response. */
+    resourceIds?: string[];
+}
+export interface CommonCursorPaging {
+    /**
+     * Number of items to load.
+     *
+     * Default: `1000`
+     * Max: `1000`
+     */
+    limit?: number | null;
+    /**
+     * Pointer to the next or previous page in the list of results.
+     *
+     * You can get the relevant cursor token
+     * from the `pagingMetadata` object in the previous call's response.
+     * Not relevant for the first request.
+     */
+    cursor?: string | null;
+}
+export interface ListMultiServiceAvailabilityTimeSlotsResponse {
+    /** Time slots. */
+    timeSlots?: TimeSlot[];
+    /**
+     * Time zone, in IANA time zone format.
+     * Shared for all `TimeSlot`'s in response.
+     */
+    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/>
+     * `count` is not supported.
+     * </p>
+     * </blockquote>
+     */
+    cursorPagingMetadata?: CommonCursorPagingMetadata;
+}
+export interface CommonCursorPagingMetadata {
+    /** Offset that was requested. */
+    cursors?: CommonCursors;
+    /**
+     * Indicates if there are more results after the current page.
+     * If `true`, another page of results can be retrieved.
+     * If `false`, this is the last page.
+     */
+    hasNext?: boolean | null;
+}
+export interface CommonCursors {
+    /** Cursor pointing to next page in the list of results. */
+    next?: string | null;
+    /** Cursor pointing to previous page in the list of results. */
+    prev?: string | null;
+}
+export interface GetMultiServiceAvailabilityTimeSlotRequest {
+    /**
+     * Services for which the multiService time slots are being returned for.
+     * Each service contains its own resources filters within.
+     *
+     * MinSize: 2.
+     * MaxSize: 8.
+     */
+    services: Service[];
+    /**
+     * Local start date of the time slot, in ISO-8601 format.
+     * For example, "2024-01-30T13:30:00".
+     */
+    localStartDate: string;
+    /**
+     * Local end date of the time slot, in ISO-8601 format.
+     * For example, "2024-01-30T14:30:00".
+     */
+    localEndDate: string;
+    /** Time zone, in IANA time zone format. */
+    timeZone: string | null;
+    /**
+     * The location of the time slot.
+     *
+     * You must provide a specific `locationType`.
+     * If locationType is `BUSINESS`, you __must__ also provide a locationId.
+     *
+     * <blockquote class="important">
+     * <p><strong>Important:</strong><br/>
+     * `name` and `formattedAddress` are ignored.
+     * </p>
+     * </blockquote>
+     */
+    location: Location;
+}
+export interface GetMultiServiceAvailabilityTimeSlotResponse {
+    /** Time slot. */
+    timeSlot?: TimeSlot;
+    /** The time zone, in IANA time zone format. */
+    timeZone?: string | null;
+}
+export interface ListAvailabilityTimeSlotsRequest {
+    /**
+     * Service ID for which the time slots are being returned for.
+     * Currently supports only services of type `Appointment`.
+     * Required, unless `cursorPaging`.`cursor` is provided.
+     */
+    serviceId?: string | null;
+    /**
+     * Lower boundary for `localStartDate` to include in response, in ISO-8601 format.
+     * For example, "2024-01-30T13:30:00".
+     * Required, unless `cursorPaging`.`cursor` is provided.
+     * > __Note:__: Each returned `TimeSlot` in response has a `localStartDate`
+     * > within the provided `fromLocalDate` and `toLocalDate` exclusive.
+     */
+    fromLocalDate?: string | null;
+    /**
+     * Upper boundary for `localStartDate` to include in response, in ISO-8601 format.
+     * For example, "2024-01-30T14:30:00".
+     * Required, unless `cursorPaging`.`cursor` is provided.
+     * > __Note:__: Each returned `TimeSlot` in response has a `localStartDate`
+     * > within the provided `fromLocalDate` and `toLocalDate` exclusive.
+     * > The `localEndDate` of the returned `TimeSlot` is the `TimeSlot`'s `localStartDate` + the service duration
+     */
+    toLocalDate?: string | null;
+    /**
+     * Time zone, in IANA time zone format.
+     * Required, unless `cursorPaging`.`cursor` is provided.
+     */
+    timeZone?: string | null;
+    /**
+     * Locations to include in response.
+     *
+     * By default,
+     * if no locations are provided,
+     * the response contains `TimeSlot`'s for all locations where the service is available.
+     *
+     * You can specify locations or location types for which the time slots will be returned for.
+     * > __Note:__ Supports filtering by location type, or by locationId. Other fields like `name` are ignored.
+     * > If locationType is `BUSINESS`, you __must__ provide a locationId.
+     */
+    locations?: Location[];
+    /**
+     * Resources to include in response.
+     *
+     * If specified,
+     * the returned time slots will contain __up__ to 10 available resources out of the provided list.
+     * Otherwise, the returned time slots returns with an empty `AvailableResources`.
+     * > __Note:__ Not specifying `resourceIds` can be handy in case you want to avoid large response in flows that only
+     * > interested whether the time slots are available or not. [An example for such flow](https://bo.wix.com/wix-docs/rest/all-apis/wix-service-availability/service-availability-time-slots/sample-flows#all-apis_wix-service-availability_service-availability-time-slots_sample-flows_let-your-customers-to-dynamically-select-an-available-time-slot-for-any-of-your-business-services).
+     */
+    resourceIds?: string[];
+    /**
+     * Resource type ID's to include in response, this is in addition to the requested resourceIds.
+     *
+     * If specified in request, the returned time slots will contain __up__ to 10 `AvailableResources` with `ResourceTypeId`
+     * out of those specified, each contains __up__ to 10 available resources of this type.
+     */
+    includeResourceTypeIds?: string[];
+    /**
+     * Whether the `TimeSlot` is bookable according to the service's booking policies.
+     *
+     * If booking this time slot 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.
+     */
+    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`.
+     */
+    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 `TimeSlot`'s 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.
+     */
+    timeSlotsPerDay?: number | null;
+    /**
+     * CursorPaging.
+     *
+     * Enables you to fetch `TimeSlot`'s in smaller, more manageable chunks
+     * by setting a limit on the number of `TimeSlots` 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.
+     *
+     * __TODO: This is only describes the current behavior, should be fixed__
+     * <blockquote class="important">
+     * <p><strong>Important:</strong><br/>
+     * If you only provide a `cursorPaging`.`cursor`,
+     * the response will contain the default size of results = 1000.
+     * </p>
+     * </blockquote>
+     *
+     * cursorPaging.limit:
+     * Default: 1000
+     * Max: 1000
+     */
+    cursorPaging?: CommonCursorPaging;
+}
+export interface ListAvailabilityTimeSlotsResponse {
+    /** Time slots. */
+    timeSlots?: TimeSlot[];
+    /**
+     * Time zone, in IANA time zone format.
+     * Shared for all `TimeSlot`'s in response.
+     */
+    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/>
+     * `count` is not supported.
+     * </p>
+     * </blockquote>
+     */
+    cursorPagingMetadata?: CommonCursorPagingMetadata;
+}
+export interface GetAvailabilityTimeSlotRequest {
+    /**
+     * Service ID of the time slot.
+     * Currently supports only services of type `Appointment`.
+     */
+    serviceId: string;
+    /**
+     * Local start date of the time slot, in ISO-8601 format.
+     * For example, "2024-01-30T13:30:00".
+     */
+    localStartDate: string;
+    /**
+     * Local end date of the time slot, in ISO-8601 format.
+     * For example, "2024-01-30T14:30:00".
+     */
+    localEndDate: string;
+    /** Time zone, in IANA time zone format. */
+    timeZone: string | null;
+    /**
+     * The location of the time slot.
+     *
+     * You must provide a specific `locationType`.
+     * If locationType is `BUSINESS`, you __must__ also provide a locationId.
+     *
+     * <blockquote class="important">
+     * <p><strong>Important:</strong><br/>
+     * `name` and `formattedAddress` are ignored.
+     * </p>
+     * </blockquote>
+     */
+    location: Location;
+    /**
+     * Resources to include in response.
+     *
+     * If specified,
+     * the returned time slot contain only the available resources out of provided list.
+     * Otherwise, the returned time slot returned with all possible `AvailableResources`.
+     * > __Note:__ This can be handy in case you want to avoid large response in flows that only
+     * > interested to check the availability of the time slot for specific resources.
+     */
+    resourceIds?: string[];
+    /**
+     * Resource type ID's to include in response, this is in addition to the requested resourceIds.
+     *
+     * If specified in request, the returned time slot contain only the `AvailableResources` with `ResourceTypeId`
+     * out of those specified, each contains all the available resources of this type.
+     */
+    includeResourceTypeIds?: string[];
+}
+export interface GetAvailabilityTimeSlotResponse {
+    /** Time slot. */
+    timeSlot?: TimeSlot;
+    /** Time zone, in IANA time zone format. */
+    timeZone?: string | null;
+}
+export interface ListMultiServiceAvailabilityTimeSlotsResponseNonNullableFields {
+    timeSlots: {
+        location?: {
+            locationType: LocationType;
+        };
+        availableResources: {
+            resources: {
+                _id: string;
+            }[];
+        }[];
+        nestedTimeSlots: {
+            serviceId: string;
+            localStartDate: string;
+            localEndDate: string;
+            availableResources: {
+                resources: {
+                    _id: string;
+                }[];
+            }[];
+        }[];
+    }[];
+}
+export interface GetMultiServiceAvailabilityTimeSlotResponseNonNullableFields {
+    timeSlot?: {
+        location?: {
+            locationType: LocationType;
+        };
+        availableResources: {
+            resources: {
+                _id: string;
+            }[];
+        }[];
+        nestedTimeSlots: {
+            serviceId: string;
+            localStartDate: string;
+            localEndDate: string;
+            availableResources: {
+                resources: {
+                    _id: string;
+                }[];
+            }[];
+        }[];
+    };
+}
+export interface ListAvailabilityTimeSlotsResponseNonNullableFields {
+    timeSlots: {
+        location?: {
+            locationType: LocationType;
+        };
+        availableResources: {
+            resources: {
+                _id: string;
+            }[];
+        }[];
+        nestedTimeSlots: {
+            serviceId: string;
+            localStartDate: string;
+            localEndDate: string;
+            availableResources: {
+                resources: {
+                    _id: string;
+                }[];
+            }[];
+        }[];
+    }[];
+}
+export interface GetAvailabilityTimeSlotResponseNonNullableFields {
+    timeSlot?: {
+        location?: {
+            locationType: LocationType;
+        };
+        availableResources: {
+            resources: {
+                _id: string;
+            }[];
+        }[];
+        nestedTimeSlots: {
+            serviceId: string;
+            localStartDate: string;
+            localEndDate: string;
+            availableResources: {
+                resources: {
+                    _id: string;
+                }[];
+            }[];
+        }[];
+    };
+}
+/**
+ * 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 `APPOINTMENT`.
+ * </p>
+ * </blockquote>
+ *
+ * The request body __must__ include one of:
+ *
+ * + All of the following filters:  `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 list of services in a specific location, 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`.
+ *
+ * > __Notes:__
+ * >  + All nested time slots share the same location.
+ * >  + You can pass up to 8 services in request.
+ *
+ * ### AvailableResources in response:
+ * <blockquote class="important">
+ * <p><strong>Important:</strong><br/>
+ * By default,
+ * if you don't specify `service`.`includeResourceTypeIds` or `service`.`resourceIds` filters in request,
+ * we return `TimeSlot`.`NestedTimeSlot`'s with an empty `AvailableResources`.
+ * </p>
+ * </blockquote>
+ *
+ * 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.
+ *
+ * > __Notes:__
+ * >
+ * > + In both cases the returned `TimeSlot`.`NestedTimeSlot`'s 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 can 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).
+ *
+ *
+ * ### 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 `TimeSlot`'s.
+ * For example,
+ * if there are no available resources to provide the service from `2024-01-30T14:30:00` to `2024-01-30T15:30:00`,
+ * we don't return `TimeSlot`'s with `localStartDate` within this range.
+ * + The response contains both `bookable` and `un-bookable` `TimeSlot`'s.
+ * 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 `TimeSlot`'s with the violating `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><br/>
+ * Because of DST, there are edge cases where certain times either do not exist or exist twice for a local time zone.
+ * Read about [DST Handling](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)
+ * </p>
+ * </blockquote>
+ *
+ *
+ * ### Pagination:
+ * You can specify how many `TimeSlot`'s will return in response by providing a `limit`
+ * for the `cursorPaging` in request.
+ *
+ * If there are more `TimeSlot`s that match the provided filters, we return a `cursorPagingMetaData`
+ * with `hasNext` = true and a `cursors`.`next` that points to the next page of results.
+ * In order to retrieve the next page of results, you should only provide `cursorPaging` with a limit and the cursor
+ * you got in previous call to `cursorPaging`.`cursor` in the request of the following call.
+ *
+ * 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.
+ *
+ * #### ListAvailabilityTimeSlots runs with the following defaults:
+ * + `cursorPaging`.`limit` is 1000.
+ * + `localStartDate` is sorted in `ASC` order.
+ * @public
+ * @documentationMaturity preview
+ * @permissionScope Read Bookings - Public Data
+ * @permissionScope Manage Bookings Services and Settings
+ * @permissionScope Read Bookings - Including Participants
+ * @permissionScope Read Bookings - all read permissions
+ * @permissionScope Read Bookings Calendar Availability
+ * @permissionScope Manage Bookings - all permissions
+ * @applicableIdentity APP
+ * @applicableIdentity MEMBER
+ * @applicableIdentity VISITOR
+ */
+export declare function listMultiServiceAvailabilityTimeSlots(options?: ListMultiServiceAvailabilityTimeSlotsOptions): Promise<ListMultiServiceAvailabilityTimeSlotsResponse & ListMultiServiceAvailabilityTimeSlotsResponseNonNullableFields>;
+export 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?: Service[];
+    /**
+     * Lower boundary for `localStartDate` to include in response, in ISO-8601 format.
+     * For example, "2024-01-30T13:30:00".
+     * Required, unless `cursorPaging`.`cursor` is provided.
+     * > __Note:__: Each returned `TimeSlot` in response has a `localStartDate`
+     * > within the provided `fromLocalDate` and `toLocalDate` exclusive.
+     */
+    fromLocalDate?: string | null;
+    /**
+     * Upper boundary for `localStartDate` to include in response, in ISO-8601 format.
+     * For example, "2024-01-30T14:30:00".
+     * Required, unless `cursorPaging`.`cursor` is provided.
+     * > __Note:__: Each returned `TimeSlot` in response has a `localStartDate`
+     * > within the provided `fromLocalDate` and `toLocalDate` exclusive.
+     */
+    toLocalDate?: string | null;
+    /**
+     * Time zone, in IANA time zone format.
+     * Required, unless `cursorPaging`.`cursor` is provided.
+     */
+    timeZone?: string | null;
+    /**
+     * Location for which the multiService time slots are being returned for.
+     *
+     * You can specify location or location type for which the time slots will be returned for.
+     * > __Note:__ Supports filtering by location type, or by locationId. Other fields like `name` are ignored.
+     * > If locationType is `BUSINESS`, you __must__ provide a locationId.
+     */
+    location?: Location;
+    /**
+     * Whether the `TimeSlot` is bookable according 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.
+     */
+    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`.
+     */
+    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 `TimeSlot`'s 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.
+     */
+    timeSlotsPerDay?: number | null;
+    /**
+     * CursorPaging.
+     *
+     * Enables you to fetch `TimeSlot`'s in smaller, more manageable chunks
+     * by setting a limit on the number of `TimeSlots` 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.
+     *
+     * __TODO: This is only describes the current behavior, should be fixed__
+     * <blockquote class="important">
+     * <p><strong>Important:</strong><br/>
+     * If you only provide a `cursorPaging`.`cursor`,
+     * the response will contain the default size of results = 1000.
+     * </p>
+     * </blockquote>
+     *
+     * cursorPaging.limit:
+     * Default: 1000
+     * Max: 1000
+     */
+    cursorPaging?: CommonCursorPaging;
+}
+/**
+ * Retrieves an available multiService `TimeSlot` that match the provided filters.
+ *
+ * Throws `SlotNotFound` if there is no such available time slot.
+ *
+ * <blockquote class="important">
+ * <p><strong>Important:</strong><br/>
+ * Currently supported only for services of type `APPOINTMENT`.
+ * </p>
+ * </blockquote>
+ *
+ * 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.
+ *
+ * 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.
+ *
+ * + Notes:
+ * + All nested time slots share the same location.
+ * + You can pass up to 8 services.
+ * @param services - Services for which the multiService time slots are being returned for.
+ * Each service contains its own resources filters within.
+ *
+ * MinSize: 2.
+ * MaxSize: 8.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField options
+ * @requiredField options.localEndDate
+ * @requiredField options.localStartDate
+ * @requiredField options.location
+ * @requiredField options.location.locationType
+ * @requiredField options.timeZone
+ * @requiredField services
+ * @requiredField services.serviceId
+ * @permissionScope Read Bookings - Public Data
+ * @permissionScope Manage Bookings Services and Settings
+ * @permissionScope Read Bookings - Including Participants
+ * @permissionScope Read Bookings - all read permissions
+ * @permissionScope Read Bookings Calendar Availability
+ * @permissionScope Manage Bookings - all permissions
+ * @applicableIdentity APP
+ * @applicableIdentity MEMBER
+ * @applicableIdentity VISITOR
+ */
+export declare function getMultiServiceAvailabilityTimeSlot(services: Service[], options: GetMultiServiceAvailabilityTimeSlotOptions): Promise<GetMultiServiceAvailabilityTimeSlotResponse & GetMultiServiceAvailabilityTimeSlotResponseNonNullableFields>;
+export interface GetMultiServiceAvailabilityTimeSlotOptions {
+    /**
+     * Local start date of the time slot, in ISO-8601 format.
+     * For example, "2024-01-30T13:30:00".
+     */
+    localStartDate: string;
+    /**
+     * Local end date of the time slot, in ISO-8601 format.
+     * For example, "2024-01-30T14:30:00".
+     */
+    localEndDate: string;
+    /** Time zone, in IANA time zone format. */
+    timeZone: string | null;
+    /**
+     * The location of the time slot.
+     *
+     * You must provide a specific `locationType`.
+     * If locationType is `BUSINESS`, you __must__ also provide a locationId.
+     *
+     * <blockquote class="important">
+     * <p><strong>Important:</strong><br/>
+     * `name` and `formattedAddress` are ignored.
+     * </p>
+     * </blockquote>
+     */
+    location: Location;
+}
+/**
+ * Retrieves a list of `TimeSlot`'s that match the provided filters.
+ *
+ * <blockquote class="important">
+ * <p><strong>Important:</strong><br/>
+ * Currently supported only for services of type `APPOINTMENT`.
+ * </p>
+ * </blockquote>
+ *
+ * The request body __must__ include one of:
+ *
+ * + All of the following filters:  `serviceId`, `fromLocalDate`, `toLocalDate`, 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 service in a specific location,
+ * and has a `localStartDate` within the range of the provided `fromLocalDate` and `toLocalDate` exclusive.
+ *
+ *
+ * ### AvailableResources in response:
+ * <blockquote class="important">
+ * <p><strong>Important:</strong><br/>
+ * By default,
+ * if you don't specify `includeResourceTypeIds` or `resourceIds` filters in request,
+ * we return `TimeSlot`'s with an empty `AvailableResources`.
+ * </p>
+ * </blockquote>
+ *
+ * If you wish to get a list of available resources for each `TimeSlot` you should either:
+ * + provide `resourceIds` in request.
+ * + provide `includeResourceTypeIds` in request.
+ *
+ * > __Notes:__
+ * >
+ * > + In both cases the returned `TimeSlot`'s 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 a specific `TimeSlot`,
+ * > you can call [GetAvailabilityTimeSlot](https://bo.wix.com/wix-docs/rest/all-apis/wix-service-availability/service-availability-time-slots/get-availability-time-slot).
+ *
+ *
+ * ### Availability VS Bookability:
+ * An available time slot is not necessarily bookable.
+ *
+ * The `bookable` field of a `TimeSlot` indicates whether a customer can book the service 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/service-availability-time-slots/introduction#all-apis_wix-service-availability_service-availability-time-slots_introduction_availability-vs-bookability).
+ *
+ * By default,
+ * + The response does not contains unavailable `TimeSlot`'s.
+ * For example,
+ * if there are no available resources to provide the service from `2024-01-30T14:30:00` to `2024-01-30T15:30:00`,
+ * we don't return `TimeSlot`'s with `localStartDate` within this range.
+ * + The response contains both `bookable` and `un-bookable` `TimeSlot`'s.
+ * For example,
+ * if the service has a booking policy which enforces booking the service up to 10 minutes before the session starts,
+ * we return `TimeSlot`'s with the violating `localStartDate` with `bookable` as false.
+ * If you want to list only __bookable__ `TimeSlots` you should pass `bookable` as true.
+ *
+ * <blockquote class="important">
+ * <p><strong>Important:</strong><br/>
+ * Because of DST, there are edge cases where certain times either do not exist or exist twice for a local time zone.
+ * Read about [DST Handling](https://bo.wix.com/wix-docs/rest/all-apis/wix-service-availability/service-availability-time-slots/introduction#all-apis_wix-service-availability_service-availability-time-slots_introduction_daylight-saving-time-dst-handling)
+ * </p>
+ * </blockquote>
+ *
+ *
+ * ### Pagination:
+ * You can specify how many `TimeSlot`'s will return in response by providing a `limit`
+ * for the `cursorPaging` in request.
+ *
+ * If there are more `TimeSlot`s that match the provided filters, we return a `cursorPagingMetaData`
+ * with `hasNext` = true and a `cursors`.`next` that points to the next page of results.
+ * In order to retrieve the next page of results, you should only provide `cursorPaging` with a limit and the cursor
+ * you got in previous call to `cursorPaging`.`cursor` in the request of the following call.
+ *
+ * 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.
+ *
+ * #### ListAvailabilityTimeSlots runs with the following defaults:
+ * + `cursorPaging`.`limit` is 1000.
+ * + `localStartDate` is sorted in `ASC` order.
+ * @public
+ * @documentationMaturity preview
+ * @permissionScope Read Bookings - Public Data
+ * @permissionScope Manage Bookings Services and Settings
+ * @permissionScope Read Bookings - Including Participants
+ * @permissionScope Read Bookings - all read permissions
+ * @permissionScope Read Bookings Calendar Availability
+ * @permissionScope Manage Bookings - all permissions
+ * @applicableIdentity APP
+ * @applicableIdentity MEMBER
+ * @applicableIdentity VISITOR
+ */
+export declare function listAvailabilityTimeSlots(options?: ListAvailabilityTimeSlotsOptions): Promise<ListAvailabilityTimeSlotsResponse & ListAvailabilityTimeSlotsResponseNonNullableFields>;
+export interface ListAvailabilityTimeSlotsOptions {
+    /**
+     * Service ID for which the time slots are being returned for.
+     * Currently supports only services of type `Appointment`.
+     * Required, unless `cursorPaging`.`cursor` is provided.
+     */
+    serviceId?: string | null;
+    /**
+     * Lower boundary for `localStartDate` to include in response, in ISO-8601 format.
+     * For example, "2024-01-30T13:30:00".
+     * Required, unless `cursorPaging`.`cursor` is provided.
+     * > __Note:__: Each returned `TimeSlot` in response has a `localStartDate`
+     * > within the provided `fromLocalDate` and `toLocalDate` exclusive.
+     */
+    fromLocalDate?: string | null;
+    /**
+     * Upper boundary for `localStartDate` to include in response, in ISO-8601 format.
+     * For example, "2024-01-30T14:30:00".
+     * Required, unless `cursorPaging`.`cursor` is provided.
+     * > __Note:__: Each returned `TimeSlot` in response has a `localStartDate`
+     * > within the provided `fromLocalDate` and `toLocalDate` exclusive.
+     * > The `localEndDate` of the returned `TimeSlot` is the `TimeSlot`'s `localStartDate` + the service duration
+     */
+    toLocalDate?: string | null;
+    /**
+     * Time zone, in IANA time zone format.
+     * Required, unless `cursorPaging`.`cursor` is provided.
+     */
+    timeZone?: string | null;
+    /**
+     * Locations to include in response.
+     *
+     * By default,
+     * if no locations are provided,
+     * the response contains `TimeSlot`'s for all locations where the service is available.
+     *
+     * You can specify locations or location types for which the time slots will be returned for.
+     * > __Note:__ Supports filtering by location type, or by locationId. Other fields like `name` are ignored.
+     * > If locationType is `BUSINESS`, you __must__ provide a locationId.
+     */
+    locations?: Location[];
+    /**
+     * Resources to include in response.
+     *
+     * If specified,
+     * the returned time slots will contain __up__ to 10 available resources out of the provided list.
+     * Otherwise, the returned time slots returns with an empty `AvailableResources`.
+     * > __Note:__ Not specifying `resourceIds` can be handy in case you want to avoid large response in flows that only
+     * > interested whether the time slots are available or not. [An example for such flow](https://bo.wix.com/wix-docs/rest/all-apis/wix-service-availability/service-availability-time-slots/sample-flows#all-apis_wix-service-availability_service-availability-time-slots_sample-flows_let-your-customers-to-dynamically-select-an-available-time-slot-for-any-of-your-business-services).
+     */
+    resourceIds?: string[];
+    /**
+     * Resource type ID's to include in response, this is in addition to the requested resourceIds.
+     *
+     * If specified in request, the returned time slots will contain __up__ to 10 `AvailableResources` with `ResourceTypeId`
+     * out of those specified, each contains __up__ to 10 available resources of this type.
+     */
+    includeResourceTypeIds?: string[];
+    /**
+     * Whether the `TimeSlot` is bookable according to the service's booking policies.
+     *
+     * If booking this time slot 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.
+     */
+    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`.
+     */
+    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 `TimeSlot`'s 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.
+     */
+    timeSlotsPerDay?: number | null;
+    /**
+     * CursorPaging.
+     *
+     * Enables you to fetch `TimeSlot`'s in smaller, more manageable chunks
+     * by setting a limit on the number of `TimeSlots` 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.
+     *
+     * __TODO: This is only describes the current behavior, should be fixed__
+     * <blockquote class="important">
+     * <p><strong>Important:</strong><br/>
+     * If you only provide a `cursorPaging`.`cursor`,
+     * the response will contain the default size of results = 1000.
+     * </p>
+     * </blockquote>
+     *
+     * cursorPaging.limit:
+     * Default: 1000
+     * Max: 1000
+     */
+    cursorPaging?: CommonCursorPaging;
+}
+/**
+ * Retrieves an available `TimeSlot` that match the provided filters.
+ *
+ * Throws `SlotNotFound` if there is no such available time slot.
+ *
+ * <blockquote class="important">
+ * <p><strong>Important:</strong><br/>
+ * Currently supported only for services of type `APPOINTMENT`.
+ * </p>
+ * </blockquote>
+ *
+ * By default,
+ * if you don't provide `includeResourceTypeIds` or `resourceIds` in request,
+ * we return all `AvailableResources` with all `AvailableResources`.`resources` which are available to provide
+ * the service within the time slot.
+ *
+ * If you specify `includeResourceTypeIds` or `resourceIds` in request,
+ * the returned `TimeSlot` 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.
+ * @param serviceId - Service ID of the time slot.
+ * Currently supports only services of type `Appointment`.
+ * @public
+ * @documentationMaturity preview
+ * @requiredField options.localEndDate
+ * @requiredField options.localStartDate
+ * @requiredField options.location
+ * @requiredField options.timeZone
+ * @requiredField serviceId
+ * @permissionScope Read Bookings - Public Data
+ * @permissionScope Manage Bookings Services and Settings
+ * @permissionScope Read Bookings - Including Participants
+ * @permissionScope Read Bookings - all read permissions
+ * @permissionScope Read Bookings Calendar Availability
+ * @permissionScope Manage Bookings - all permissions
+ * @applicableIdentity APP
+ * @applicableIdentity MEMBER
+ * @applicableIdentity VISITOR
+ */
+export declare function getAvailabilityTimeSlot(serviceId: string, options?: GetAvailabilityTimeSlotOptions): Promise<GetAvailabilityTimeSlotResponse & GetAvailabilityTimeSlotResponseNonNullableFields>;
+export interface GetAvailabilityTimeSlotOptions {
+    /**
+     * Local start date of the time slot, in ISO-8601 format.
+     * For example, "2024-01-30T13:30:00".
+     */
+    localStartDate: string;
+    /**
+     * Local end date of the time slot, in ISO-8601 format.
+     * For example, "2024-01-30T14:30:00".
+     */
+    localEndDate: string;
+    /** Time zone, in IANA time zone format. */
+    timeZone: string | null;
+    /**
+     * The location of the time slot.
+     *
+     * You must provide a specific `locationType`.
+     * If locationType is `BUSINESS`, you __must__ also provide a locationId.
+     *
+     * <blockquote class="important">
+     * <p><strong>Important:</strong><br/>
+     * `name` and `formattedAddress` are ignored.
+     * </p>
+     * </blockquote>
+     */
+    location: Location;
+    /**
+     * Resources to include in response.
+     *
+     * If specified,
+     * the returned time slot contain only the available resources out of provided list.
+     * Otherwise, the returned time slot returned with all possible `AvailableResources`.
+     * > __Note:__ This can be handy in case you want to avoid large response in flows that only
+     * > interested to check the availability of the time slot for specific resources.
+     */
+    resourceIds?: string[];
+    /**
+     * Resource type ID's to include in response, this is in addition to the requested resourceIds.
+     *
+     * If specified in request, the returned time slot contain only the `AvailableResources` with `ResourceTypeId`
+     * out of those specified, each contains all the available resources of this type.
+     */
+    includeResourceTypeIds?: string[];
+}