Room Group

Group rooms into reference buckets

What it does: Assigns each supplier room to one reference bucket.

Workflow role: Alternate sync view (not step 0 of the main flow).

Use when: You want reference-centric grouping instead of per-supplier scores.

Do not use when: You need ranked candidates or async persistence.

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

post/rooms/group/with-reference

Request

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

Request body

hotelIdstring nullable

Correlation ID echoed in the response

chunkKeystring nullable

Batch/chunk ID for large jobs

thresholdnumber

Minimum score to attach a supplier to a reference group

Example request

{
  "hotelId": "hotel-1",
  "chunkKey": "chunk-1",
  "threshold": 0.8,
  "references": [
    {
      "name": "King Room"
    }
  ],
  "suppliers": [
    {
      "name": "Deluxe King"
    }
  ]
}

Response

OK

Example response

{
  "data": {
    "hotelId": "hotel-1",
    "supplier_assignment": "best_reference_exclusive"
  }
}

Changes

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