Room Match

Submit an async room mapping job

What it does: Starts a background mapping job for one hotel (jobId to poll).

Workflow role: Step 1 — create or refresh hotel mappings.

Use when: Hotel onboarding, catalog refresh, or sending trusted attributes (supplierRooms, optional referenceRooms, attributeDetail).

Do not use when: You only need instant sync scores — use POST /rooms/match.

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

post/rooms/match/async

Request

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

Request body

Example request

{
  "hotelId": "lp32f8b",
  "referenceRooms": [
    {
      "id": 1,
      "name": "King Room",
      "attributes": {
        "structure": "studio",
        "tier": "deluxe",
        "bedrooms": 1,
        "beds": [
          {
            "type": "queen",
            "label": "Queen bed",
            "count": 2,
            "sizeCm": "151-180 cm wide"
          }
        ],
        "bedRelation": "none",
        "occupancy": {
          "maxAdults": 4,
          "maxChildren": 3,
          "maxOccupancy": 4
        },
        "size": {
          "value": 24,
          "unit": "sqm"
        },
        "views": [
          "city"
        ],
        "accessibility": [
          "mobility_accessible",
          "roll_in_shower"
        ],
        "features": {
          "non_smoking": true,
          "television": true
        },
        "amenities": [
          "desk",
          "private bathroom"
        ]
      }
    }
  ],
  "roomNames": [
    "Deluxe King",
    "Standard Twin Room",
    "1 King Junior Suite"
  ],
  "supplierRooms": [
    {
      "name": "Studio, 2 Queen",
      "attributes": {
        "structure": "studio",
        "tier": "deluxe",
        "bedrooms": 1,
        "beds": [
          {
            "type": "queen",
            "label": "Queen bed",
            "count": 2,
            "sizeCm": "151-180 cm wide"
          }
        ],
        "bedRelation": "none",
        "occupancy": {
          "maxAdults": 4,
          "maxChildren": 3,
          "maxOccupancy": 4
        },
        "size": {
          "value": 24,
          "unit": "sqm"
        },
        "views": [
          "city"
        ],
        "accessibility": [
          "mobility_accessible",
          "roll_in_shower"
        ],
        "features": {
          "non_smoking": true,
          "television": true
        },
        "amenities": [
          "desk",
          "private bathroom"
        ]
      }
    }
  ]
}

Response

Accepted - job queued

Example response

{
  "data": {
    "jobId": "dm_1777386480123456789_a1b2c3d4e5f6a7b8",
    "status": "queued",
    "hotelId": "lp32f8b"
  }
}

Changes

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