Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mapping.travel/llms.txt

Use this file to discover all available pages before exploring further.

Mapping.Travel helps travel companies resolve partner hotel data into a canonical reference dataset. Upload your partner inventory in CSV, JSON, Excel, or Parquet format, run a mapping job to match hotels against the global reference database, and export enriched results — complete with supplier IDs, match confidence scores, and geographic data.

Quick Start

Make your first API call in minutes. Upload inventory and start a mapping job.

Authentication

Learn how to authenticate your API requests with Bearer tokens.

Inventory Upload

Upload CSV, JSON, Excel, or Parquet hotel inventory files for processing.

Run a Mapping

Start a mapping job using Standard, ID-to-ID, or Hybrid mode.

API Reference

Full reference for all public API endpoints with request and response schemas.

Billing & Plans

Understand plan limits, credits, and how usage is tracked.

How it works

1

Upload your inventory

Send your partner hotel file to POST /api/v1/inventory. Supported formats: CSV, JSON, Excel (.xlsx), and Parquet. You’ll receive an uploadId to track processing.
2

Start a mapping job

Call POST /api/v1/mapping with your partnerInventoryId. Choose from Standard (fuzzy), ID-to-ID, or Hybrid mapping mode depending on your supplier setup.
3

Poll for results

Check job status with GET /api/v1/mapping/{mappingJobId}. Once complete, search and filter results with rich filters including hotel name, city, country, and supplier IDs.
4

Export enriched data

Download your matched results directly or configure a webhook to receive exports automatically when each mapping job completes.

Key capabilities

Multiple Mapping Modes

Use fuzzy matching, exact ID-to-ID mapping against a specific supplier, or Hybrid mode that combines both for maximum coverage.

Supplier Connections

Connect to supported suppliers (Expedia, Booking, Airbnb, and more) to enable precise ID-to-ID hotel matching.

Export Webhooks

Configure webhook endpoints to automatically receive export files when mapping jobs complete.

Reference Hotel Search

Search the global reference hotel database by name, location, country, or city — with fuzzy and geographic search support.