> Portal Navigation:
> 
> - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version.
> - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages).
> - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`).
> - Top-level index of all portals: https://dev.wix.com/docs/llms.txt
> - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt

## Resource: Introduction

## Article: Introduction

## Article Link: https://dev.wix.com/docs/api-reference/business-solutions/bookings/time-slots/time-slots-v2/introduction.md

## Article Content:

# About the Time Slots V2 API

The Time Slots V2 API allows you to retrieve information about when [services](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/introduction.md) are available for booking. You can check availability for single-service or multi-service bookings, and get detailed information about each time slot including: whether the slot is bookable, available resources, and any booking restrictions.

With the Time Slots V2 API, you can:

- List time slots available for services within a specified time range.
- Get detailed information about specific time slots.
- Filter time slots by location, resources, and whether customers can book them.
- Determine why certain time slots aren't bookable due to policy violations.

## Availability calculation

The availability calculation for a service is based on:

- **Service configurations**: Duration, buffer time between sessions, and other service-specific settings.
- **Operating hours**: Business opening hours by default. However, if the service requires exactly one resource and that resource is a staff member, availability extends to that staff member's working hours, even if they work outside regular business hours.
- **Resource availability**: Whether all required resources are available during the requested time.
- **Booking policies**: Service-specific rules that may restrict when bookings can be made.

## Key concepts

**Availability vs. bookability:** An available time slot has all required resources free, but may not be bookable due to service policies, such as minimum advance booking time.

**Capacity information:** Time slots include total capacity, remaining available spots, and bookable capacity that accounts for waitlist reservations.

**Resource filtering:** Control which time slots are returned and which resource details are included in responses.

**Policy violations:** Determine why slots aren't bookable. For example, the booking is too far in advance or too close to the appointment time, or online booking is disabled for the service.

## Before you begin

It's important to note the following points before starting to code:

- [Wix Bookings](https://www.wix.com/app-market/web-solution/bookings) must be installed on a site before you can use the Time Slots V2 API.
- Only appointment-based services and classes are supported. For course availability, follow the [end-to-end booking flow for courses](https://dev.wix.com/docs/rest/business-solutions/bookings/end-to-end-booking-flows.md#book-a-course).
- Time slots aren't returned when they have no available resources.
- Daylight saving time (DST) transitions are automatically handled when using IANA time zone formats.

## Use cases

- [Book an appointment](https://dev.wix.com/docs/rest/business-solutions/bookings/time-slots/time-slots-v2/sample-flows.md#book-an-appointment).
- [Book a class session](https://dev.wix.com/docs/rest/business-solutions/bookings/time-slots/time-slots-v2/sample-flows.md#book-a-class-session).
- [Check availability for multi-service bookings](https://dev.wix.com/docs/rest/business-solutions/bookings/time-slots/time-slots-v2/sample-flows.md#check-availability-for-multi-service-bookings).

## Terminology

- **Time slot**: A specific period when a service can be booked.
- **Available slot**: A time slot with all required resources free.
- **Bookable slot**: An available slot that doesn't violate any service booking policies.
- **Resource**: Staff members, equipment, or facilities needed to provide a service.
- **Capacity**: The maximum number of participants a service can accommodate in a time slot.

For a comprehensive glossary of Wix Bookings terms, see [Terminology](https://dev.wix.com/docs/rest/business-solutions/bookings/terminology.md).

## See also

- [Services V2 API](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/introduction.md): Manage bookable services.
- [Bookings Writer V2 API](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/introduction.md): Create and manage single-service and multi-service bookings.
- [Resources V2 API](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-v2/introduction.md): Manage bookable resources.