Ancillary RevenueAuth: API Key Only (Listings) or Bearer JWT (Subscriptions)

Hotel Services & Subscriptions API

Showcase extra property amenities such as fitness memberships, cabana rentals, spa packages, and valet passes. Guests can browse offerings and purchase subscriptions.

GEThttps://api.thegrandeur.vip/api/v1/hotel-services/public

Header Parameters

X-API-Keystringrequired

Your hotel live public API key.

Example: hak_live_8f3a1290...

Authorizationstring

Required when creating subscriptions or querying /hotel-services/subscriptions/mine.

Example: Bearer eyJhbGciOiJIUzI1NiIsIn...

# 1) Get Public Hotel Services
curl -s "https://api.thegrandeur.vip/api/v1/hotel-services/public" \
  -H "X-API-Key: hak_live_YOUR_KEY"

# 2) Subscribe to Service (e.g. 3-Day Spa Access)
curl -s -X POST "https://api.thegrandeur.vip/api/v1/hotel-services/subscriptions" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "X-API-Key: hak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": "srv_spa_wellness",
    "guest_id": "usr_9a4f21b",
    "plan": "Weekend Pass",
    "amount_paid": 75.0,
    "payment_reference": "ref_tx_9921"
  }'

# 3) Get Authenticated Guest Subscriptions
curl -s "https://api.thegrandeur.vip/api/v1/hotel-services/subscriptions/mine" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "X-API-Key: hak_live_YOUR_KEY"

Response Preview

{
  "success_status": true,
  "message": "Services retrieved",
  "data": [
    {
      "id": "srv_spa_wellness",
      "name": "Thermal Spa & Sauna Pass",
      "description": "Full day access to hydrothermal pools, Finnish sauna, and steam room.",
      "pricing_plans": [
        {
          "name": "Daily",
          "price": 25,
          "duration_days": 1
        },
        {
          "name": "Weekend Pass",
          "price": 60,
          "duration_days": 3
        }
      ],
      "icon_url": "https://cdn.thegrandeur.vip/icons/spa.png"
    }
  ]
}

Guest Concierge Requests

Payments & Tax Settings