Booking Slots

Returns the runtime availability of slots for a booking product on a specific date. The Bagisto booking system supports five booking types (default, appointment, rental, event, table); the slot-config block lives on the parent product (see bookingProducts[] in Single Product). This endpoint converts that config + a target date into the actual bookable time slots.

Endpoint

GET /api/shop/booking-slots

Request Headers

Header	Required	Description
Accept	Yes	application/json
X-STOREFRONT-KEY	Yes	Storefront API key (pk_storefront_…)
X-Locale	No	Override request locale
X-Channel	No	Override channel scope

Query Parameters

Parameter	Type	Required	Description
id	integer	Yes	Booking product ID — i.e. bookingProducts[].id from a parent product, not the parent product's id.
date	string	Yes	Target date in YYYY-MM-DD format. Times in the response are computed against the channel's timezone for that date.

Pagination headers are not emitted. The response is the full list of slots for that date in one shot.

Response shape — by booking type

The internal structure depends on the booking product's type field. The API auto-routes to the right shape based on the parent booking product, so you don't pick which response — you get the right one for the product.

Flat slots (default · appointment · event · table)

[
  { "slotId": "...", "from": "12:00 PM", "to": "06:00 PM", "timestamp": "1777876200-1777897800", "qty": "5" }
]

Field	Type	Description
slotId	string	Stable identifier — pass it back to the cart endpoint when adding the slot.
from	string	Slot start time (hh:mm AM/PM)
to	string	Slot end time
timestamp	string	Unix from-to range — server-computed, useful for logging and analytics
qty	string | null	Remaining capacity. null for types that don't track per-slot inventory

Grouped slots (rental hourly)

[
  {
    "slotId": "1",
    "time": "10:00 AM - 12:00 PM",
    "slots": [
      { "from": "10:00 AM", "to": "11:00 AM", "timestamp": "1777867200-1777870800", "qty": "5" }
    ]
  }
]

Field	Type	Description
slotId	string	Sequential index of the time-range group
time	string	Group label (e.g. "10:00 AM - 12:00 PM")
slots	array	Nested hourly sub-slots — same { from, to, timestamp, qty } shape as flat slots

Typical Flow

GET /api/shop/products/110
   └─ response.type            = "booking"
   └─ response.bookingProducts = [{ id: 1, type: "default", … }]

GET /api/shop/booking-slots?id=1&date=2026-05-04
   └─ [{ slotId: "...", from: "12:00 PM", to: "06:00 PM", … }]

The id you pass to /booking-slots is the booking product ID (the entry from the parent's bookingProducts[] array), not the parent product ID.

Empty results

A 200 OK with an empty array [] means "the product is bookable in principle but has no slots on this date". Common causes:

• The booking product's weekly schedule excludes that day of the week.
• All slots for the date are sold out.
• The date is before/after the booking product's allowed window.

Use Cases

• Render a date-picker on a booking-product detail page that shows available slots when a date is selected.
• Validate a chosen slotId before adding it to the cart (re-fetch with the same date to confirm it's still in the response).
• Power an admin "view today's bookings" tool — combine ?date= with each active booking product.

Related Resources

• Single Product — embeds the bookingProducts[] slot config that this endpoint dereferences
• Products — discover booking products via ?type=booking
• Search Products — the full filter, sort, and search reference