Get availability slots for a given date-time and guest count

By sending a date-time and guestCount, the POS can fetch all the slots during the booking window containing the datetime, with their availability in UTC timezone. If the guestCount exceeds the maxGuestsPerBooking of the booking window, slot will be returned but with the maximum value available in the durationPerGuestCount.

GET/v1/availability/slots/{bookingWindowId}

Authorization

authorization<token>

To get an API key, please contact us. We'll be happy to help you.

In: header

Path Parameters

bookingWindowIdstring

ID of the booking window

Formatuuid

Query Parameters

datestring

Formatdate-time

guestCountinteger

Range1 <= value

bookingIdToExclude?string

locationId?string

Formatuuid

Response Body

application/json

curl -X GET "http://localhost:4008/v1/availability/slots/497f6eca-6276-4993-bfeb-53cbbbba6f08?date=2019-08-24T14%3A15%3A22Z&guestCount=1"

[
  {
    "startsAt": "2025-01-14T12:00:00.000Z",
    "endsAt": "2025-01-14T13:00:00.000Z",
    "currentGuestOccupation": 0,
    "totalGuestCapacity": 20,
    "hasFreeTables": true
  },
  {
    "startsAt": "2025-01-14T12:15:00.000Z",
    "endsAt": "2025-01-14T13:15:00.000Z",
    "currentGuestOccupation": 0,
    "totalGuestCapacity": 20,
    "hasFreeTables": true
  },
  {
    "startsAt": "2025-01-14T12:30:00.000Z",
    "endsAt": "2025-01-14T13:30:00.000Z",
    "currentGuestOccupation": 0,
    "totalGuestCapacity": 20,
    "hasFreeTables": true
  },
  {
    "startsAt": "2025-01-14T12:45:00.000Z",
    "endsAt": "2025-01-14T13:45:00.000Z",
    "currentGuestOccupation": 0,
    "totalGuestCapacity": 20,
    "hasFreeTables": true
  },
  {
    "startsAt": "2025-01-14T13:00:00.000Z",
    "endsAt": "2025-01-14T14:00:00.000Z",
    "currentGuestOccupation": 0,
    "totalGuestCapacity": 20,
    "hasFreeTables": true
  },
  {
    "startsAt": "2025-01-14T13:15:00.000Z",
    "endsAt": "2025-01-14T14:15:00.000Z",
    "currentGuestOccupation": 0,
    "totalGuestCapacity": 20,
    "hasFreeTables": true
  },
  {
    "startsAt": "2025-01-14T13:30:00.000Z",
    "endsAt": "2025-01-14T14:30:00.000Z",
    "currentGuestOccupation": 0,
    "totalGuestCapacity": 20,
    "hasFreeTables": true
  },
  {
    "startsAt": "2025-01-14T13:45:00.000Z",
    "endsAt": "2025-01-14T14:45:00.000Z",
    "currentGuestOccupation": 18,
    "totalGuestCapacity": 20,
    "hasFreeTables": false
  },
  {
    "startsAt": "2025-01-14T14:00:00.000Z",
    "endsAt": "2025-01-14T15:00:00.000Z",
    "currentGuestOccupation": 20,
    "totalGuestCapacity": 20,
    "hasFreeTables": false
  }
]

Get availability days status for a given date range GET

Previous Page

Get available tables for a specified slot POST

Next Page