Skip to main content

Rooms Catalog

The rooms endpoint provides access to room type catalog data including descriptions, images, occupancy details, and bed configurations.

Endpoint​

POST /content/hotels/v1/rooms

Use Cases​

Get Room Details​

{
  "query": {
    "roomCodes": ["ROOM-001"]
  }
}

List Rooms by Connection​

{
  "query": {
    "connectionCode": "CONN_1",
    "maxSize": 100
  }
}

Response Structure​

{
  "rooms": {
    "rooms": [
      {
        "code": "ROOM-001",
        "roomData": {
          "name": "Standard Double Room",
          "maxOccupancy": 2,
          "bedType": "Double",
          "sizeSqM": 25,
          "texts": [
            {
              "text": "Comfortable double room with city view",
              "languageCode": "en"
            }
          ],
          "images": [
            {
              "url": "https://example.com/room-image.jpg",
              "order": 1
            }
          ],
          "occupancy": {
            "adults": 2,
            "children": 0,
            "total": 2
          },
          "beds": [
            {
              "type": "Double",
              "count": 1
            }
          ]
        }
      }
    ],
    "count": 1,
    "token": null
  }
}

Key Fields​

  • code - Bundleport room code
  • name - Room name
  • maxOccupancy - Maximum guests
  • bedType - Type of bed
  • sizeSqM - Room size in square meters
  • texts - Multi-language descriptions
  • images - Room images
  • occupancy - Occupancy details
  • beds - Bed configuration

Next Steps​