Skip to main content

Guest Service API

The Guest Service API provides self-service capabilities for hotel guests to manage their stay experience, request services, and interact with hotel staff through a comprehensive digital platform.

Overview​

The Guest Service API enables guests to:

  • Digital Check-in/Check-out - Complete check-in and check-out flows digitally
  • Service Requests - Request housekeeping, maintenance, and on-demand services
  • Personalized Recommendations - Receive AI-powered recommendations and book amenities
  • Real-time Communication - Communicate with hotel staff in real time
  • Profile Management - Manage profile, preferences, and stay history
  • Booking Management - View and manage current and future bookings

Key Features​

Self-Service Capabilities​

  • Digital check-in and check-out processes
  • Room service and amenity requests
  • Housekeeping and maintenance service requests
  • Concierge service requests
  • Restaurant and spa bookings

Personalization​

  • AI-powered recommendations based on guest preferences
  • Personalized offers and upselling opportunities
  • Context-aware suggestions based on stay timeline
  • Historical preference learning

Real-time Updates​

  • WebSocket connections for instant notifications
  • Service request status updates
  • Staff message notifications
  • Recommendation alerts

Mobile Integration​

  • Deep linking support for mobile apps
  • Push notification capabilities
  • Offline capability considerations
  • Native mobile app integration

Authentication Methods​

Booking Reference Authentication​

  • Primary authentication method using booking reference and guest details
  • Secure session establishment for web applications
  • JWT token generation for mobile applications
  • Multi-step verification for enhanced security

Session Management​

  • Session-based authentication for web applications
  • Token-based authentication for mobile applications
  • Secure session timeout and renewal
  • Device-specific session management

Privacy & Security​

Data Protection​

  • Guest data retention policies (automatic purge after checkout + 30 days)
  • End-to-end encryption for sensitive communications
  • GDPR-compliant data export and deletion
  • Separate consent management for marketing vs operational communications

Security Features​

  • TLS encryption for all communications
  • Field-level encryption for sensitive data
  • Rate limiting and abuse prevention
  • Audit logging for guest actions

Service Categories​

Core Services​

  • Housekeeping - Room cleaning, towel/linen requests, amenity restocking
  • Maintenance - Room issue reporting and resolution tracking
  • Concierge - Local recommendations, booking assistance, special requests
  • Room Service - Food and beverage ordering and delivery

Amenity Services​

  • Spa & Wellness - Treatment bookings and wellness service requests
  • Dining - Restaurant reservations and special dining arrangements
  • Recreation - Activity bookings, equipment rentals, event participation
  • Transportation - Shuttle services, taxi booking, car rental assistance

Communication Services​

  • Messaging - Real-time chat with hotel staff
  • Notifications - Stay-related updates and alerts
  • Feedback - Service feedback and review submission
  • Support - Help desk and issue resolution