Skip to main content
Once your inventory upload reaches COMPLETED status, you can start a mapping job. mapping.travel matches your partner hotels against the reference hotel database and returns a count of matched and unmatched hotels. The job runs asynchronously. Poll for its status until it completes.

​
Choosing a mapping mode

The mode field in your mapping request controls the matching strategy. Choose based on what data you have available. STANDARD runs a fuzzy matching pipeline against the full reference database. It’s the best default choice when you don’t have supplier IDs. ID_TO_ID matches exclusively by supplier external IDs. Every hotel in your inventory must have a supplierCode column, and you must pass the matching supplierCode when uploading the file. Hotels without a supplier ID are left unmatched. HYBRID runs ID_TO_ID first. Any hotels not matched by ID fall through to the fuzzy pipeline. This gives you the precision of ID matching where possible, with coverage from fuzzy matching for the rest.
ID_TO_ID and HYBRID both require a supplierCode on your inventory upload. If the inventory has no supplier code, the API returns a 400 Bad Request.
1

Start the mapping job

Send a POST request to /api/v1/mapping with your partnerInventoryId and chosen mode.
A successful request returns HTTP 202 Accepted:
Save the mappingJobId to poll for status and to search results later.
2

Poll for job status

Check the job status with GET /api/v1/mapping/{mappingJobId} until status is COMPLETED or FAILED.
Poll every 5 to 10 seconds. Small inventories (under 1,000 hotels) typically complete in under a minute. Larger files may take several minutes.
3

Review the results summary

The completed job response includes three key counts:
  • rowCount: total number of hotels in your inventory
  • matchedCount: hotels successfully matched to a reference hotel
  • unmatchedCount: hotels with no match found
For HYBRID jobs, matchedCount includes hotels matched by both ID_TO_ID and the fuzzy fallback pipeline.To see individual match results and drill into specific hotels, use the search results endpoint.

​
Quota and credits

Each mapping job counts against your daily quota. On the free plan, you can run 10 mapping jobs per day. On subscription plans, you get a higher daily limit. If you exceed your daily limit, you need credits to continue. Each credit covers one additional mapping job. The API returns a 403 Forbidden if you have no remaining quota and no credits. Check your current quota before starting a job:
See Billing and Quotas for details on purchasing credits and upgrading your plan.

​
List all mapping jobs

To view all mapping jobs for your organization: