Get to know our frameworks

Select an app template built on your preferred framework.

Build apps on our native app editor. Use drag and drop elements, Velo code and Wix APIs to develop custom features.

Streamline your app development process with the Wix CLI. Get a familiar developer experience with minimal setup and configuration.

Take full control over your app's tech stack, deployment, and hosting.

App templates

Wix Blocks templates

Wix CLI templates

Self-hosted templates

Kickstart your app development with templates built on your preferred Wix developer tool. Browse templates for practical foundation and get to know the Wix ecosystem.

Wix App Templates for Developers

This example apps can be used as a starting point for building your own app, for concrete examples of how to use Wix framework, or for inspiration.

Choose a template.<0 />Build an app.

Browse by:

How to build it step by step:

This template is built with:

Read how this template was built, step by step.

How we built this template

Deployment instructions:

Choose a package manager and run the command in your terminal.

Copy command

Before you get started, make sure you have the following:

Prerequisite steps

Get started with Wix CLI

Begin by setting up your Next.js project with your preferred hosting platform.

Select your hosting service

Start the deployment flow and set up your template repo on Netlify. After you finish set up, come back here and add your Netlify custom domain.

Copy the code from our Git repo to deploy your app on any platform that supports Next.js.

Start the deployment flow and set up your template repo on Vercel. After you finish set up, come back here and add your Vercel generated URL.

Add the base URL and give your app a name.

App details

Go to the app dashboard and test your app to ensure a smooth integration within the Wix ecosystem. <0>Learn more about app checks and testing</0>

Define your environment

Terminal

Related templates

Note

Warning

Your app name will be used as the namespace suffix.

Name your app to generate a namespace. This lets you refer to your app in code later on.

Go Headless

Build Apps

Client

API Preview

Ricos

Develop Websites

REST

Velo

GraphQL (Alpha)

ID of the reservation location for which to check the time slot.

reservationLocationId

string

options

CheckTimeSlotOptions

Checks a restaurant's availability to accommodate a reservation for a given party size in a given time slot.

 `checkTimeSlot()` returns availability information for the restaurant's table combinations, and flags any party pacing or seat pacing conflicts that the proposed reservation would cause.

import { timeSlots } from 'wix-table-reservations.v2';

async function checkTimeSlot(reservationLocationId, options) {
  try {
    const result = await timeSlots.checkTimeSlot(reservationLocationId, options);
    return result;
  } catch (error) {
    console.error(error);
    // Handle the error
  }
}


checkTimeSlot example for dashboard page code

import { timeSlots } from 'wix-table-reservations.v2';
import { webMethod, Permissions } from 'wix-web-module';
import { elevate } from 'wix-auth';

const elevatedCheckTimeSlot = elevate(timeSlots.checkTimeSlot);

export const checkTimeSlot = webMethod(
  Permissions.Anyone,
  async (reservationLocationId, options) => {
    try {
      const result = await elevatedCheckTimeSlot(reservationLocationId, options);
      return result;
    } catch (error) {
      console.error(error);
      // Handle the error
    }
  }
);


checkTimeSlot example for exporting from backend code

checkTimeSlot

Manage Reservations (Full)

Manage Reservations (Medium)

Manage Restaurants - all permissions

CheckTimeSlotResponse

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

Date and time for which to retrieve a time slot in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601#coordinated_Universal_Time_(UTC)) format.

date

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

Min: `1`

partySize

number

GetTimeSlotsOptions

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.

import { timeSlots } from 'wix-table-reservations-v2';

/* Sample reservationLocationId value: 'fab8cc1f-31cf-462f-b5bb-392594624bf2'
 * Sample date value: new Date("2023-12-29T12:30:00Z")
 * Sample partySize value: 2
 */

timeSlots.getTimeSlots(reservationLocationId, new Date(date), partySize)
  .then((retrievedSlots) => {
    const firstStartDate = retrievedSlots.items[0].startDate;
    const firstStatus = retrievedSlots.items[0].status;

    console.log('Success! Retrieved the following time slots:', retrievedSlots);
    return retrievedSlots;
  })
  .catch((error) => {
    console.error(error);
    // Handle the error
  });

/* Promise resolves to:
 * {
 *   "timeSlots": [
 *     {
 *       "startDate": "2023-12-29T10:00:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T10:15:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T10:30:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T10:45:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *   },
 *     {
 *       "startDate": "2023-12-29T11:00:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T11:15:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T11:30:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T11:45:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T12:00:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T12:15:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T12:30:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T12:45:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T13:00:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T13:15:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T13:30:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T13:45:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T14:00:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T14:15:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T14:30:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T14:45:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T15:00:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     }
 *   ]
 * }
 */


Get time slots for a given date,location, and party size (page code) @description:

import { timeSlots } from 'wix-table-reservations-v2';

/* Sample reservationLocationId value: 'fab8cc1f-31cf-462f-b5bb-392594624bf2'
 * Sample date value: new Date("2023-12-29T12:30:00Z")
 * Sample partySize value: 2
 * 
 * Sample options value: 
 * {
 *   "duration": 5,
 *   "slotsAfter": 1,
 *   "slotsBefore": 0
 * }
 */

timeSlots.getTimeSlots(reservationLocationId, new Date(date), partySize)
  .then((retrievedSlots) => {
    const firstStartDate = retrievedSlots.items[0].startDate;
    const firstStatus = retrievedSlots.items[0].status;

    console.log('Success! Retrieved the following time slots:', retrievedSlots);
    return retrievedSlots;
  })
  .catch((error) => {
    console.error(error);
    // Handle the error
  });

/* Promise resolves to:
* {
*   "timeSlots": [
*     {
*       "startDate": "2023-12-29T12:30:00.000Z",
*       "duration": 5,
*       "status": "UNAVAILABLE",
*       "tableCombinations": [],
*       "manualApproval": false
*     },
*     {
*       "startDate": "2023-12-29T12:45:00.000Z",
*       "duration": 5,
*       "status": "UNAVAILABLE",
*       "tableCombinations": [],
*       "manualApproval": false
*     }
*   ]
* }
*/


This example gets a 5-minute time slot at the selected date, and the next 5-minute time slot after it.

Get time slots with options (page code) 

import { Permissions, webMethod } from 'wix-web-module';
import { timeSlots } from 'wix-table-reservations-v2';

/* Sample reservationLocationId value: 'fab8cc1f-31cf-462f-b5bb-392594624bf2'
 * Sample date value: new Date("2023-12-29T12:30:00Z")
 * Sample partySize value: 2
 */

export const myGetTimeSlotsFunction = webMethod(Permissions.Anyone, async (options) => {
  try {
    const retrievedSlots = await timeSlots.getTimeSlots(reservationLocationId, new Date(date), partySize)

    const firstStartDate = retrievedSlots.items[0].startDate;
    const firstStatus = retrievedSlots.items[0].status;

    console.log('Success! Retrieved the following time slots:', retrievedSlots);
    return retrievedSlots;
  } catch (error) {
    console.error(error);
    // Handle the error
  }

});

/* Promise resolves to:
 * {
 *   "timeSlots": [
 *     {
 *       "startDate": "2023-12-29T10:00:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T10:15:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T10:30:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T10:45:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *   },
 *     {
 *       "startDate": "2023-12-29T11:00:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T11:15:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T11:30:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T11:45:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T12:00:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T12:15:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T12:30:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T12:45:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T13:00:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T13:15:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T13:30:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T13:45:00.000Z",
 *       "duration": 90,
 *       "status": "UNAVAILABLE",
 *       "tableCombinations": [],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T14:00:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T14:15:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T14:30:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T14:45:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     },
 *     {
 *       "startDate": "2023-12-29T15:00:00.000Z",
 *       "duration": 90,
 *       "status": "AVAILABLE",
 *       "tableCombinations": [
 *         {
 *           "tableIds": [
 *             "1ed802ae-708f-4da6-9177-54c3df5d3dd5"
 *           ]
 *         }
 *       ],
 *       "manualApproval": false
 *     }
 *   ]
 * }
 */

Get time slots for a given date,location, and party size (backend) @description:

/* This example requires the following elements:
 * A dropdown element named `locationDropdown`.
 * A dropdown element named `partySizeDropdown`.
 * A dropdown element named `timeSlotDropdown`.
 * A button named `confirmButton`.
 * A text element named `heldReservationNotification`.
 */

/**********************************************
 * Backend code - reservationLocations.web.js *
 **********************************************/

import { Permissions, webMethod } from 'wix-web-module';
import { locations } from 'wix-business-tools.v2';
import { elevate } from 'wix-auth';

export const getRestaurantLocation = webMethod(Permissions.Anyone, async (location_id) => {
  const elevatedGetLocation = elevate(locations.getLocation);

  try {
     const result = await elevatedGetLocation(location_id);
     return result;
   } catch (error) {
     console.error(error);
     // Handle the error
   }
});

/*************
 * Page code *
 *************/

import { reservationLocations } from 'wix-table-reservations.v2';
import { reservations } from 'wix-table-reservations.v2';
import { timeSlots } from 'wix-table-reservations.v2';

import { getRestaurantLocation } from 'backend/reservationLocations.web';

$w.onReady(async function () {
  $w('#timeSlotDropdown').hide();
  $w('#partySizeDropdown').hide();
  $w('#confirmButton').hide();
  $w('#heldReservationNotification').hide();

  //Get the list of reservation locations
  const myReservationLocationList = await (async () => {
    try {
      let fullListObject = await reservationLocations.listReservationLocations();
      return fullListObject.reservationLocations;
    } catch (error) {
     console.error(error);
     // Handle the error
   }
  })();

  //Create an array to hold names and values for our locations dropdown list
  let locationDropdownOptions = [];
  for (const object in myReservationLocationList){
    //Use the _id stored in the reservation location's location object to get the location's name from the `locations` service
    const locationObject = await getRestaurantLocation(myReservationLocationList[object].location._id);
    locationDropdownOptions.push({
      "label": locationObject.name, 
      "value": myReservationLocationList[object]._id
    })	
  }
  //Populate our dropdown list with the array
  $w("#locationDropdown").options = locationDropdownOptions;

  //Create an array to hold numbers and values for our party size dropdown list
  let partySizeDropdownOptions = [];
  for (let i = 1; i<10; i++){
    partySizeDropdownOptions.push({
      "label": String(i), 
      "value": String(i)
    })	
  }
  //Populate our dropdown list with the array
  $w("#partySizeDropdown").options = partySizeDropdownOptions;

  $w('#locationDropdown').onChange( (event) => {
    if ($w('#locationDropdown').value) {
      $w('#partySizeDropdown').show();
      $w('#timeSlotDropdown').hide()
      $w('#confirmButton').hide();
    }
  });

  $w('#partySizeDropdown').onChange( async (event) => {
    if ($w('#locationDropdown').value) {
      $w('#timeSlotDropdown').show()
      $w('#confirmButton').hide();

      const timeSlotDetails = {
        "reservationLocationId": $w('#locationDropdown').value, 
        "date": new Date(),
        "partySize": parseInt($w('#partySizeDropdown').value)
      };

      const timeSlotOptions = {
        "duration": 30,
	"slotsAfter": 8,
	"slotsBefore": 0
      };

      //Get the list of time slots according to the details and options above
      const availableTimeSlots = await (async () => {
        try {
          let fullListObject = await timeSlots.getTimeSlots(timeSlotDetails.reservationLocationId, timeSlotDetails.date, timeSlotDetails.partySize, timeSlotOptions);
          return fullListObject.timeSlots;
        } catch (error) {
          console.error(error);
          // Handle the error
        }
      })();

      //Create an array to hold numbers and values for our time slot dropdown list
      let timeSlotDropdownOptions = [];
      for (const timeSlot in availableTimeSlots){
        if(availableTimeSlots[timeSlot].status == "AVAILABLE"){
          timeSlotDropdownOptions.push({
            "label": String(availableTimeSlots[timeSlot].startDate), 
            "value": String(availableTimeSlots[timeSlot].startDate)
          })
        }	
      }
      //Populate our dropdown list with the array
      $w("#timeSlotDropdown").options = timeSlotDropdownOptions;
    }
  });

  $w('#timeSlotDropdown').onChange( async (event) => {
    if ($w('#timeSlotDropdown').value) {
      $w('#confirmButton').show();
    }
  });

  $w('#confirmButton').onClick( async (event) => {
    //Get the list of time slots according to the details and options above
    
    const createdHeldReservation = await (async () => {
      try {
        const reservationDetails = {
          "reservationLocationId": $w('#locationDropdown').value, 
          "startDate": new Date($w("#timeSlotDropdown").value),
          "partySize": parseInt($w('#partySizeDropdown').value)
        };

        return await reservations.createHeldReservation(reservationDetails);
      } catch (error) {
        console.error(error);
        // Handle the error
      }
    })();

    if(createdHeldReservation){
      $w('#heldReservationNotification').text = "Held reservation created successfully."
      $w('#heldReservationNotification').show();
    }
  });
});


This scenario sets up an interface that allows a site owner to select a reservation location and a party size, then select a time slot to reserve. Once a time slot is selected, the site owner can click a confirm button to create a held reservation at that time.

Create a held reservation with a given time, location, and party size. 

getTimeSlots

Manage Reservations (Basic)

GetTimeSlotsResponse

---
title: Introduction
---

# 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:
* You must install the Wix Table Reservations app.
* You must have at least 1 location configured in your Dashboard under [Business Info](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).
* To use the Time Slots API, import `timeSlots` from `wix-table-reservations.v2`:

```js
import { timeSlots } from 'wix-table-reservations.v2';
```
## Terminology
For a comprehensive glossary of Table Reservations terms, see [Terminology](https://www.wix.com/velo/reference/wix-table-reservations-v2/terminology).


velo-deps_wix-table-reservations.v2_time-slots

CheckReservationDetailsOptions

duration

Reservation, that should be ignored during the check.

excludeReservationId

tableIds

CheckReservationDetailsResponse

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

manualApproval

boolean

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

paymentRequired

requestedTableCombination

TableCombination

reservationLocationConflicts

tableCombinations

List of reserved tables with corresponding reservation ids.

tableReservedConflicts

tables

Duration of the time slot in minutes .

Min: `5`

ID of a reservation to ignore during the check.

Use this when rescheduling a reservation to exclude it in its current state from the availability calculations.

Party size to check the restaurant's availability for.

Reservation location conflicts that would occur by making a reservation for the given party size in the given time slot.

Table combinations and their availability information.

tableCombinationAvailabilities

Duration in minutes of the time slot.

Min: `5`

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

slotsAfter

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

slotsBefore

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

timeSlots

ReservationLocationConflict

type

Type

Status

Table

tableConflicts

tableCombinationConflicts

TableCombinationAvailability

Conflicts that would be generated by attempting to accommodate the proposed reservation using the table combination.

IDs of the tables in the table combination.

TableCombinationConflict

TableCombinationConflictType

TableConflict

TableConflictType

TableReservedConflict

reservationIds

tableId

TimeSlot

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

TimeSlotTableCombination

Table IDs of the tables in the combination.

checkTimeSlot( )