Skip to main content

Hotel Admin API

The Hotel Admin API provides comprehensive administrative capabilities for hotel managers and staff to manage property operations, guest services, and business analytics through a powerful administrative interface.

Overview​

The Hotel Admin API enables:

  • Property Management - Hotel settings, room configurations, and amenity management
  • Guest Management - Guest profiles, bookings, and comprehensive service history
  • Staff Management - User roles, permissions, and task assignments
  • Analytics & Reporting - Revenue insights, guest satisfaction metrics, and operational analytics
  • Service Configuration - AI recommendations, pricing strategies, and service offerings
  • Operations Management - Real-time operational oversight and workflow management

Key Features​

Comprehensive Property Management​

  • Hotel configuration and settings management
  • Room inventory and status management
  • Amenity and service catalog configuration
  • Rate and pricing management
  • Property-level policy and preference settings

Advanced Guest Management​

  • Complete guest profile management
  • Booking lifecycle management (reservations, modifications, cancellations)
  • Guest service history and preference tracking
  • Communication history and interaction logs
  • Guest satisfaction and feedback management

Operational Excellence​

  • Real-time operational dashboards
  • Staff task management and assignment
  • Service request monitoring and dispatch
  • Maintenance scheduling and tracking
  • Housekeeping workflow management

Business Intelligence​

  • Revenue analytics and forecasting
  • Occupancy and performance metrics
  • Guest satisfaction and sentiment analysis
  • Operational efficiency metrics
  • Comparative performance reporting

Multi-Tenant Architecture​

The API is designed with multi-tenant architecture in mind:

  • Hotel-Scoped Operations - All operations are automatically scoped to the authenticated user's hotel property
  • Role-Based Access Control - Fine-grained permissions based on staff roles and responsibilities
  • Subscription Tier Management - Feature access based on subscription levels
  • Tenant Isolation - Complete data isolation between different hotel properties

Request Context​

Each authenticated request includes hotel context:

{
  "hotel_id": "hotel_123",
  "user_permissions": ["admin", "guest_management", "analytics"],
  "subscription_tier": "professional",
  "tenant_features": ["ai_recommendations", "advanced_analytics"]
}

Authentication & Authorization​

JWT Token Authentication​

All endpoints require valid JWT tokens with hotel-specific permissions:

Authorization: Bearer <jwt_token>
Content-Type: application/json

Permission Levels​

  • Super Admin - Full system access across all properties
  • Hotel Admin - Complete access to assigned hotel property
  • Manager - Operational management with limited administrative access
  • Staff - Limited access to assigned operational areas
  • Read-Only - View-only access for reporting and analytics

Performance & Scalability​

Rate Limiting​

  • Standard Operations - 1,000 requests per hour per hotel
  • Analytics Endpoints - 100 requests per hour per hotel
  • Bulk Operations - 50 requests per hour per hotel
  • Real-time Updates - WebSocket connections for live data

Caching Strategy​

  • Property configuration data cached for 1 hour
  • Guest data cached for 15 minutes
  • Analytics data cached for 5 minutes
  • Real-time operational data not cached

Integration Capabilities​

PMS Integration​

  • Seamless integration with major Property Management Systems
  • Real-time data synchronization
  • Bidirectional booking and guest data flow
  • Automated reconciliation processes

Third-Party Services​

  • Payment gateway integrations
  • Channel manager connectivity
  • Revenue management system integration
  • Guest communication platform integration

Webhook Support​

  • Real-time event notifications
  • Configurable webhook endpoints
  • Retry mechanisms for failed deliveries
  • Event filtering and subscription management