Catalog & InventoryAuth: API Key Only

Rooms & Availability API

Inspect your property's room categories, individual rooms, dynamic seasonal rates, and search real-time calendar availability for guest reservations.

GEThttps://api.thegrandeur.vip/api/v1/rooms/available

Header Parameters

X-API-Keystringrequired

Your hotel live public API key.

Example: hak_live_8f3a1290...

Query Parameters

check_instring (YYYY-MM-DD)required

Check-in arrival date.

Example: 2026-10-01

check_outstring (YYYY-MM-DD)required

Check-out departure date.

Example: 2026-10-05

room_type_idUUID

Optional filter for a specific room category.

Example: 9b1deb4d-3b7d-4bad-9bdd-2b0d7b3dcb6d

Inventory Synchronization Guarantee

The /rooms/available query locks in sync with the property's PMS tape chart. If a walk-in guest checks in at the front desk or a reservation arrives via Booking.com, the room inventory is automatically blocked in real-time to avoid double-bookings.

# 1) Search Available Rooms
curl -s "https://api.thegrandeur.vip/api/v1/rooms/available?check_in=2026-10-01&check_out=2026-10-05" \
  -H "X-API-Key: hak_live_YOUR_KEY"

# 2) List All Room Types (Deluxe, Presidential, etc.)
curl -s "https://api.thegrandeur.vip/api/v1/rooms/types" \
  -H "X-API-Key: hak_live_YOUR_KEY"

# 3) Get Aggregated Availability Matrix
curl -s "https://api.thegrandeur.vip/api/v1/rooms/availability?check_in=2026-10-01&check_out=2026-10-05" \
  -H "X-API-Key: hak_live_YOUR_KEY"

Response Preview

{
  "success_status": true,
  "message": "Available rooms fetched",
  "data": [
    {
      "id": "room_101",
      "room_number": "101",
      "room_type_id": "rt_deluxe_ocean",
      "type_name": "Deluxe Ocean View",
      "base_price": 280,
      "currency": "USD",
      "max_occupancy": 3,
      "amenities": [
        "King Bed",
        "Balcony",
        "Free Wi-Fi",
        "Minibar"
      ],
      "images": [
        "https://cdn.thegrandeur.vip/media/deluxe-ocean-1.jpg"
      ]
    }
  ]
}

Authentication

Bookings & Stays