Logo PopinaPopina API

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.

GET/v1/availability/slots/{bookingWindowId}
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
  }
]