Court Booking & Occupancy

Each court has its own bookable calendar with per-court time slots that can be filtered by date and court number. The public availability endpoint exposes the same data unauthenticated so that club websites and the player app can render an occupancy grid without forcing sign-in. Recurring weekly, biweekly, and monthly series are supported with conflict-aware expansion, and cancellations on a series propagate to all future instances unless the user opts to cancel only one.

Pricing is computed per court and per hour. Each court can carry its own tariff with a venue-level default fallback, and the booking engine auto-calculates the fee from the venue's pricing configuration — including peak versus off-peak windows. A booker_type flag distinguishes member from guest, applying the correct tariff so members get the negotiated club rate while guests are charged at the public price. Lighting and heating are bookable amenities: each court declares whether it has heating, and if the booker enables lighting or heating the engine validates the court actually supports it and adds the surcharge from the venue's amenity pricing.

Cancellation enforces a venue-defined deadline policy. Bookings cancelled before the deadline incur no fee, those cancelled late incur a percentage fee, and a force-cancel option lets staff override for legitimate cases. No-show registration is a separate POST /no-show action that charges the no-show fee from the cancellation policy; it cannot be applied if the booker has already checked in, preventing accidental penalties.

Check-in runs on QR codes. Each booking is issued a unique check_in_token, retrievable via GET /check-in-token and rendered as a QR code in the app or on the booking confirmation. POST /check-in validates the token, marks attendance, and unlocks the no-show protection.

Real-time availability is served from GET /public/venues/{id}/real-time-availability, which returns a per-court, per-slot grid with configurable slot duration. This single call powers booking screens, embedded widgets, and the public app's drop-in finder.