API
Bookings
Index of all booking endpoints — public/guest and authenticated.
Base path: /api/v1/bookings
Booking endpoints are split into two pages depending on whether the caller is authenticated.
Public / Guest — cms-booki-web-app
organizationId is resolved from x-tenant-slug header, subdomain, or :organizationId route param. See Key Concepts.
| Method | Path | Description |
|---|---|---|
| POST | /api/v1/bookings/type/:type | Create guest booking (tenant from header/subdomain) |
| POST | /api/v1/bookings/organizations/:orgId/type/:type | Create guest booking (org ID explicit in URL) |
| PUT | /api/v1/bookings/:id/verify | Verify booking via email token |
| GET | /api/v1/bookings/fully-booked-slots | List fully-booked time slots for a branch |
| GET | /api/v1/bookings/:id | Get booking by ID |
→ Full details: Bookings - Public & Guest
Authenticated — customer-booki-web-app
organizationId is read from the customer's JWT token. Authorization: Bearer <accessToken> header required.
| Method | Path | Description |
|---|---|---|
| POST | /api/v1/bookings | Create booking as logged-in customer |
| GET | /api/v1/bookings | List bookings for current customer |
| PUT | /api/v1/bookings/:id/reschedule | Request reschedule |
| PUT | /api/v1/bookings/:id/cancel | Cancel booking |
→ Full details: Bookings - Authenticated