Overview

Submit an async room mapping job for a hotel. The job processes in the background and produces high-quality mappings with detailed reasoning for each decision. Only one job per hotel can run at a time.

Note: Internally referred to as a deep-map job.

When to Use

• Batch processing - Map large sets of supplier rooms for a hotel
• Initial hotel setup - Establish canonical mappings when onboarding a property
• Periodic refresh - Re-map rooms when supplier catalogs change

What You Get

• Job ID - Unique identifier to poll for results
• Queued status - Immediate confirmation that processing has started
• Background processing - Results ready in seconds to minutes

Quick Start

Required fields: hotelId, referenceRooms (your catalog, max 500), roomNames (supplier names to map, max 100)

Poll for results: Use GET /rooms/match/async/jobs/:jobId until status is completed or failed