Room Group

Group rooms without a reference catalog

What it does: Clusters supplier room names without a reference catalog.

Workflow role: Outside the main four-step flow — exploration only.

Use when: You do not have catalog rooms yet.

Do not use when: You have a catalog — use /rooms/match or async.

Details, examples, limits, and result codes: Implementation Workflow (doc page: implementation-workflow).

post/rooms/group

Request

  • Base URL
    https://api.liteapi.travel/v3.0
  • URL
    https://api.liteapi.travel/v3.0/rooms/group
  • Auth
    API key in header X-API-Key

Request body

debugboolean

When true, returns parsed entities per room

propertyNamestring required

Display name of the hotel

propertyIdstring required

Stable property identifier in your catalog

Example request

{
  "propertyName": "Azure Bay Resort",
  "propertyId": "property-001",
  "parameters": {
    "outputAggregation": [
      "roomClass",
      "roomType",
      "bedType",
      "roomView"
    ]
  },
  "supplierList": [
    {
      "supplierName": "Supplier 1",
      "supplierId": "supplier-1",
      "supplierRooms": [
        {
          "roomId": "room-1",
          "roomName": "Standard King Room"
        }
      ]
    }
  ]
}

Response

OK

Example response

{
  "data": {
    "property": "Azure Bay Resort",
    "propertyId": "property-001",
    "aggregation": [
      {
        "groupCode": "STD-KING",
        "groupName": "Standard King Room"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.