Introduction

The Reservations API allows you to create and manage reservations at restaurants.

This API provides all the necessary functionality to move a reservation through the phases of its lifecycle, such as from the reservation request until completion.

The Reservations API works together with the Reservation Locations API, which provides information about the physical location of a restaurant, as well as that restaurant’s availability and reservation conditions.

The Reservations API also works together with the Time Slots API, which allows you to retrieve availability information about time slots at a restaurant on a specific date and for a specific party size.

With the Reservations API, you can:

• Create and manage reservations at a restaurant.
• Get information about existing reservations at a restaurant.

Before you begin

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

• The site or project owner must install the Wix Table Reservations app.
• The site or project owner must have at least 1 location configured in their Dashboard under Business Info.

Permissions information

The following methods have different permission requirements depending on the fields specified, and the value of certain fields.

Create Reservation

Create Reservation requires additional permissions when the following fields are specified:

• status
• source
• reservation.details.tableIds
• reservation.details.endDate
• ignoreReservationLocationConflicts
• ignoreTableCombinationConflicts

These additional permission requirements are as follows:

• In an app, specifying the above fields requires the MANAGE RESERVATIONS (FULL) permission scope.
• On a headless site, specifying the above fields requires API key authorization with appropriate permissions.
• On a Wix site, specifying the above fields requires elevated permissions.

If a source is not specified, the value assigned to it depends on the permissions of the identity making the call:

• In an app, if you're authorized as an identity with the MANAGE RESERVATIONS (FULL) permission scope, source is set to UNDEFINED. Otherwise, source is set to ONLINE.
• On a headless site, if you're authorized as a visitor or member, source is set to ONLINE.
• On a Wix site, if the method is called with elevated permissions, source is set to UNDEFINED. Otherwise, source is set to ONLINE.

Get Reservation

Calling Get Reservation with fieldsets set to FULL requires additional permissions:

• In an app, the FULL fieldset requires either the MANAGE RESERVATIONS (MEDIUM) or MANAGE RESERVATIONS (FULL) permission scope.
• On a headless site, retrieving the FULL fieldset requires API key authorization with appropriate permissions.
• On a Wix site, retrieving the FULL fieldset requires elevated permissions.

Terminology

For a comprehensive glossary of Table Reservations terms, see Terminology.