What it does: For each supplier room, returns the best reference room match with confidence scores and ranked alternatives.

Workflow role: Optional step 0 — quick sync scoring before async hotel jobs.

Use when: You need an immediate answer with suppliers. Either send references yourself, or omit references and set hotelId so the service resolves the catalog (room_mapping_catalog → LiteAPI data API; your references win if supplied; max 500 rooms).

Do not use when: You need persisted mappings, audit reasons, or room attributes — use POST /rooms/match/async. Not for clustering without a catalog — use POST /rooms/group.

If references is omitted: missing hotelId or unresolvable catalog → 400; Redis or data API failure → 500; suppliers×references over upstream cap → 413 when configured.

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