Grandeur RoyalHOSPITALITY CLOUD
← API docs

Create a booking

Guests must be logged in (JWT). Register/login with the hotel X-API-Key so the guest attaches to the correct account owner.

# 1) Login (or register) with hotel key — same as frontend/
curl -X POST "https://api.thegrandeur.vip/api/v1/auth/login" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: hak_live_YOUR_KEY" \
  -d '{"email":"[email protected]","password":"••••","audience":"guest_site","api_key":"hak_live_YOUR_KEY"}'

# Or Google (browser):
# https://api.thegrandeur.vip/api/v1/social/google/login?api_key=hak_live_YOUR_KEY&return_origin=https://your-site

# 2) Create booking
curl -X POST "https://api.thegrandeur.vip/api/v1/bookings/" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "X-API-Key: hak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "room_type_id": "<uuid>",
    "check_in": "2026-10-01",
    "check_out": "2026-10-03",
    "guests": 2
  }'

Exact body fields follow the live OpenAPI / PMS booking schema. This page does not simulate responses — use a real key and token.