Housekeeping & ConciergeAuth: Bearer JWT + API Key
Guest Concierge Requests API
Enables in-house guests to request room amenities, housekeeping, spa appointments, luggage handling, and concierge assistance from their personal device.
POST
https://api.thegrandeur.vip/api/v1/bookings/guest-requestHeader Parameters
AuthorizationstringrequiredBearer guest access token.
Example: Bearer eyJhbGciOiJIUzI1NiIsIn...
X-API-KeystringrequiredYour hotel live public API key.
Example: hak_live_8f3a1290...
Request Body Schema (JSON)
booking_idUUIDrequiredActive booking UUID of the guest making the request.
Example: bk_9812a
request_typestring ('towels' | 'housekeeping' | 'spa' | 'concierge' | 'other')requiredCategory of service requested.
Example: housekeeping
notesstringoptionalDetailed instructions or preferences for staff.
Example: Please provide extra hypoallergenic pillows.
Real-time Staff Notification
Guest requests are pushed instantly via WebSockets to the hotel's Staff Mobile App and PMS Front Desk dashboard, ensuring rapid response times and complete accountability.
# Submit a Service Request
curl -s -X POST "https://api.thegrandeur.vip/api/v1/bookings/guest-request" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "X-API-Key: hak_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"booking_id": "bk_9812a",
"request_type": "towels",
"notes": "We need 2 fresh pool towels delivered to room 304."
}'
Response Preview
{
"success_status": true,
"message": "Guest request submitted successfully",
"data": {
"ticket_id": "tkt_req_441",
"booking_id": "bk_9812a",
"room_number": "304",
"request_type": "towels",
"status": "assigned",
"created_at": "2026-10-02T15:20:00.000Z"
}
}