Luxurious Suites.AI

Developer portal

An API for every layer of the stay.

Integrate the platform with your property systems, or build your own guest surfaces on top of the orchestration layer. All examples below use clearly fictional credentials.

GET/v1/properties/:id/roomsList rooms and current connected state
GET/v1/rooms/:id/stateRead canonical room state across adapters
POST/v1/rooms/:id/commandsIssue a permission-checked device command
GET/v1/guests/:id/preferencesRead consented guest preference profile
PATCH/v1/guests/:id/preferencesUpdate or redact preference fields
POST/v1/automationsCreate a pre-arrival or scheduled automation
POST/v1/ordersCreate an F&B or amenity order via the POS adapter
GET/v1/eventsStream orchestration and device events
GET/v1/audit-logsQuery immutable action records

Authentication

Scoped keys and signed webhooks.

Request

curl https://api.example-luxurious-suites.ai/v1/rooms/2104/commands \
  -H "Authorization: Bearer sk_demo_0000_example_only" \
  -H "X-Tenant: meridian-house" \
  -d '{
    "intent": "lighting.set_scene",
    "payload": { "scene": "warm", "level": 40 }
  }'

Response

{
  "status": "SUCCESS",
  "risk": "low",
  "decision": "ALLOW",
  "devices": ["light-2104-bed", "light-2104-living"],
  "latency_ms": 148,
  "audit_id": "aud_demo_41b7e"
}

Fictional keys and hosts for illustration. Real credentials are issued in the admin console and never rendered in documentation.

Webhooks

React to the stay in real time.

guest.preferences.updated
room.state.changed
automation.prearrival.completed
order.status.changed
device.health.degraded
integration.connection.failed
ai.action.escalated
audit.entry.created
stay.checkin.completed

SDKs

First-party clients.

TypeScript / NodePythonSwiftKotlinJavaGoEmbedded C (gateway)