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.

Use Cases

Reservation app for restaurants on a Wix site


For a comprehensive glossary of Reservations terms, see Terminology.

Was this helpful?

Time Slot Object

Time Slots Submodule Docs

startDatestringformat date-time

Start date and time of this time slot.


Duration in minutes of this time slot.

3 enum supported values:

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.


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

Was this helpful?

PostGet Time Slots

Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

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 startDates of time slots in the response are 15 minutes apart regardless of the duration provided.

Permission Scopes

For app development, you must have one of the following permission scopes:
Manage Reservations (Medium)
Manage Reservations (Full)
Manage Reservations (Basic)
Learn more about permission scopes.

Was this helpful?