# Mapping API Docs

## Docs

- [View plans and start a Stripe checkout or portal session](https://docs.mapping.travel/api/billing/plans.md): Browse plan tiers and credits pricing, then create Stripe checkout or portal sessions to subscribe, buy credits, or manage your subscription.
- [Quota status, credit balance, usage, and metrics](https://docs.mapping.travel/api/billing/quota.md): Check your real-time daily quota, credit balance, cumulative usage summary, and monthly metrics history to monitor and manage your Mapping.Travel consumption.
- [Get subscription status and plan usage details](https://docs.mapping.travel/api/billing/subscription.md): Retrieve your Stripe subscription state and a usage-focused plan summary including matches used, quota remaining, and cost accrued this billing period.
- [Configure your export format for mapping results](https://docs.mapping.travel/api/export-format/config.md): Set or retrieve the export format configuration that controls how Mapping.Travel structures and delivers hotel mapping results for your organization.
- [Configure export webhooks for mapping result delivery](https://docs.mapping.travel/api/export-webhooks/overview.md): Create, retrieve, update, and delete webhook configurations that Mapping.Travel uses to push hotel mapping results to your HTTP endpoints after each export run.
- [Cancel an in-progress inventory upload](https://docs.mapping.travel/api/inventory/cancel.md): Cancel an in-progress upload and mark it CANCELLED. Only PENDING or PROCESSING uploads can be cancelled. Returns the upload ID and a confirmation message.
- [Generate a presigned inventory download URL](https://docs.mapping.travel/api/inventory/download.md): Generate a short-lived presigned download URL for an inventory file. The URL expires after 60 seconds and requires no extra authentication headers.
- [List all inventory uploads for your organization](https://docs.mapping.travel/api/inventory/list.md): Retrieve all hotel inventory uploads for your organization, with pagination. Returns summaries including status, row counts, and file metadata for each upload.
- [Get inventory upload status and processing progress](https://docs.mapping.travel/api/inventory/status.md): Retrieve the current processing status and metadata for an inventory upload. Poll this endpoint to track progress from PENDING through to COMPLETED or FAILED.
- [Upload a hotel inventory file to Mapping.Travel](https://docs.mapping.travel/api/inventory/upload.md): Upload a CSV, JSON, Excel, or Parquet hotel inventory file to Mapping.Travel for processing. Returns an uploadId you can use to track progress.
- [Trigger a manual mapping export](https://docs.mapping.travel/api/mapping/export.md): Manually trigger an export of mapping results for a completed job. Returns an export file ID on success. Always check the success field in the response.
- [List all mapping jobs for your organization](https://docs.mapping.travel/api/mapping/list.md): Retrieve a paginated list of all mapping jobs for your organization. Each item includes the job status, mode, matched count, and unmatched count.
- [Search mapping results for a job](https://docs.mapping.travel/api/mapping/search-results.md): Filter and paginate individual hotel match results from a completed mapping job by name, city, partner ID, reference ID, or supplier.
- [Start a hotel mapping job](https://docs.mapping.travel/api/mapping/start.md): Start an asynchronous job to match partner inventory against the reference hotel database. Specify STANDARD, ID_TO_ID, or HYBRID mode. Returns a mappingJobId.
- [Get mapping job status and result counts](https://docs.mapping.travel/api/mapping/status.md): Retrieve the current status, rowCount, matchedCount, and unmatchedCount for a mapping job. Poll this endpoint until status is COMPLETED or FAILED.
- [Get a reference hotel or download the inventory](https://docs.mapping.travel/api/reference/get.md): Retrieve a single reference hotel by UUID, or get a presigned URL to download the full reference inventory file for bulk processing.
- [Search reference hotels by name or location](https://docs.mapping.travel/api/reference/search.md): Find hotels in the Mapping.Travel reference inventory using fuzzy name search, geographic radius search, or filter-based lookup with country, city, and rating.
- [Reference inventory statistics by country and city](https://docs.mapping.travel/api/reference/statistics.md): Query global hotel counts and per-country breakdowns from the Mapping.Travel reference inventory, including city-level detail for globe visualizations.
- [Connect and disconnect your organization from suppliers](https://docs.mapping.travel/api/suppliers/connect.md): Add or remove supplier connections for your organization. Your plan's supplier limit controls how many active connections you can maintain at one time.
- [List available and connected suppliers](https://docs.mapping.travel/api/suppliers/list.md): Browse all active suppliers supported by Mapping.Travel, view the suppliers connected to your organization, and check the status of your supplier requests.
- [Request a new supplier to be added to the platform](https://docs.mapping.travel/api/suppliers/request.md): Submit a supplier request with an inventory file sample so the Mapping.Travel team can evaluate and onboard a new supplier dataset to the platform.
- [Authenticate requests to the Mapping.Travel API](https://docs.mapping.travel/authentication.md): Authenticate Mapping.Travel API requests with Bearer tokens. Get your token, set the Authorization header, and handle 401, 403, and 429 error responses.
- [Buy and manage pay-as-you-go credits](https://docs.mapping.travel/billing/credits.md): Buy credits to run mapping jobs beyond your plan's daily limit. Credits cost €1 per million mappings, never expire, and are shared across your organization.
- [Mapping.Travel plans, pricing, and upgrades](https://docs.mapping.travel/billing/plans.md): Compare FREE, Subscription, and Enterprise plans. View your active plan, upgrade via Stripe checkout, or manage invoices from the Stripe customer portal.
- [Track mapping usage, quota, and billing metrics](https://docs.mapping.travel/billing/usage.md): Monitor your organization's mapping consumption in real time. Check quota status, view plan details, and pull monthly and historical cost metrics.
- [Exports: Retrieve Your Mapping Results Automatically](https://docs.mapping.travel/concepts/exports.md): Get mapping results as files on demand or via webhook. Configure export webhooks, trigger manual exports, and customize the file format for your organization.
- [Partner Inventory: Hotel Data You Upload for Matching](https://docs.mapping.travel/concepts/inventory.md): A partner inventory is a hotel file you upload for matching. Learn the supported formats, required fields, upload idempotency, and file status lifecycle.
- [Mapping Jobs: Matching Your Inventory to Reference Hotels](https://docs.mapping.travel/concepts/mapping.md): A mapping job matches your inventory against the reference dataset. Understand STANDARD, ID_TO_ID, and HYBRID modes, job statuses, and result fields.
- [Suppliers: Connect Travel Platforms for Precise Matching](https://docs.mapping.travel/concepts/suppliers.md): Suppliers are OTAs like Expedia and Booking.com. Connect one to enable ID-to-ID mapping with their hotel IDs. Plan limits control how many you can connect.
- [Manage Billing, Quotas, and Credits](https://docs.mapping.travel/guides/billing-and-quotas.md): Understand your daily mapping quota, check credit balance, view usage history, purchase additional credits, and upgrade to a higher plan via the billing API.
- [Configure Export Webhooks and File Formats](https://docs.mapping.travel/guides/export-webhooks.md): Configure a webhook URL to receive mapping export files automatically when a job completes, manage multiple endpoints, and set your preferred export format.
- [Run a Hotel Mapping Job](https://docs.mapping.travel/guides/run-mapping.md): Start a hotel mapping job against the Mapping.Travel reference database, choose the right mapping mode, and poll for results including match counts.
- [Search and Filter Hotel Mapping Results](https://docs.mapping.travel/guides/search-results.md): Filter and paginate individual hotel match results after a mapping job completes. Search by name, city, country, partner ID, reference ID, or supplier IDs.
- [Upload and Prepare Your Hotel Inventory File](https://docs.mapping.travel/guides/upload-inventory.md): Prepare and upload a hotel inventory file in CSV, JSON, Excel, or Parquet format, then poll for processing status before starting a mapping job.
- [Mapping.Travel API — Hotel Data Reconciliation](https://docs.mapping.travel/introduction.md): Mapping.Travel is a hotel mapping API for travel companies. Connect your partner inventory to a global reference dataset and resolve hotels at scale.
- [Connect your client](https://docs.mapping.travel/mcp/connect.md): Set up Claude Desktop, Cursor, or Continue with mapping.travel MCP.
- [Available tools](https://docs.mapping.travel/mcp/tools.md): 18 tools across 5 categories. Agents discover them via get_mcp_schemas at runtime.
- [Troubleshooting](https://docs.mapping.travel/mcp/troubleshooting.md): Common MCP connection errors and fixes.
- [Quickstart: Map Your First Hotel Inventory](https://docs.mapping.travel/quickstart.md): Go from zero to mapped hotel inventory in five steps. Upload a file, start a mapping job, and retrieve matched results against the global reference dataset.

## OpenAPI Specs

- [openapi](https://docs.mapping.travel/api-reference/openapi.json)