Go Headless

Build Apps

Client

API Preview

Develop Websites

REST

Velo

GraphQL (Alpha)

# Introduction

The Time Slots API allows you to retrieve availability information for time slots at a reservation location on and around a given date and for a given party size.

A time slot represents a period of time in a restaurant’s calendar. Time slots can have any duration, and restaurants generally set their durations based on party size.

The following factors influence whether a time slot at a reservation location is available:
* The size of the party that must be seated.
* The reservation location’s table and seat pacing rules.
* The reservation location’s business schedule (operating hours).
* Existing reservations at the reservation location.

With the Time Slots API, you can:
* Get time slots for a reservation location.

A time slot can have the following statuses:
* `AVAILABLE` - The restaurant is open and available to seat a party of the given size at the given date and time.
* `UNAVAILABLE` - The restaurant is open but unable to seat a party of the given size at the given date and time.
* `NON_WORKING_HOURS` - The restaurant is not open at this time.

`timeSlot` objects also indicate whether manual approval is required to make a reservation at the given reservation location.

## Before you begin
It’s important to note the following points before starting to code:
* The site owner must install the Wix Table Reservations app.
* The site owner must have at least 1 location configured in their Dashboard under [Business Info](fallback::https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Fbusiness-info).

## Use Cases
[Reservation app for restaurants on a Wix site](portalId::d1972c09-74e2-4d36-a6f2-54e3310d4ad9resourceId::03b65e54-6b8e-47eb-a5f9-72edc580978b#reservation-app-for-restaurants-on-a-wix-site*fallback::https://dev.wix.com/docs/rest/api-reference/wix-restaurants/reservations/sample-flows#reservation-app-for-restaurants-on-a-wix-site)

## Terminology
For a comprehensive glossary of Reservations terms, see [Terminology](fallback::https://dev.wix.com/docs/rest/api-reference/wix-restaurants/reservations/terminology).


value

BoolValue

Int32Value

StringValue

nanos

seconds

Timestamp

date

duration

Reservation, that should be ignored during the check.

excludeReservationId

partySize

reservationLocationId

tableIds

CheckReservationDetailsRequest

reservationLocationConflicts

tableCombinations

List of reserved tables with corresponding reservation ids.

tableReservedConflicts

tables

CheckReservationDetailsResponse

Date and time for which to retrieve a time slot.

Duration in minutes of the time slot.

Min: `5`

Size of the party that needs to be seated during this time slot.

Min: `1`

ID of the reservation location for which to retrieve time slots.

The number of time slots to retrieve after the given `date`.

slotsAfter

The number of time slots to retrieve before the given `date`.

slotsBefore

GetTimeSlotsRequest

A list of time slots and their availability according to the given party size.

timeSlots

GetTimeSlotsResponse

type

ReservationLocationConflict

Type

tableConflicts

Table

tableCombinationConflicts

TableCombination

TableCombinationConflict

TableConflict

reservationIds

tableId

TableReservedConflict

Whether manual approval is required to make a reservation in this time slot.

manualApproval

startDate

Availability status of this time slot.

* `AVAILABLE`: The restaurant can accommodate a party of the given size in this time slot.
* `UNAVAILABLE`: The restaurant can't accommodate a party of the given size in this time slot.
* `NON_WORKING_HOURS`: The restaurant is not open during this time slot.

status

TimeSlot

Status

Table IDs of the tables in the combination.

Returns a list of time slots at a given restaurant on a given `date`, and their availability for a given `partySize`.

Without passing optional parameters, the list will contain a single time slot at the given `date`.
Use `slotsBefore` and `slotsAfter` to get additional time slots before and after the given `date`.

If you do not provide a `duration`, the duration will be calculated automatically based on the reservation location's configuration.
The reservation location's settings used to determine the duration are its `defaultTurnoverTime` and `turnoverTimeRules`. These specify how much time should be allotted for a reservation of a party of a given size.

The `startDate`s of time slots in the response are 15 minutes apart regardless of the `duration` provided.

Time Slot Object