Exports

An export is a file containing your mapping results: matched hotel records with reference IDs, confidence scores, and supplier IDs, delivered after a mapping job completes. You can download a file at any time, or configure a webhook so mapping.travel pushes results to your server automatically when each job finishes. You can also customize the fields and format included in every export.

Two ways to get results

Manual download

Trigger an export on demand and receive a presigned URL to download the results file directly.

Export webhook

Configure a URL and mapping.travel calls it automatically whenever a mapping job completes.

Manual export

To trigger an export manually, call POST /api/v1/mapping/{mappingJobId}/export with your API key:

curl -X POST https://api.mapping.travel/api/v1/mapping/{mappingJobId}/export \
  -H "X-API-Key: <token>"

The response includes an exportFileId and a presigned download URL. Download the file before the URL expires.

Export webhooks

A webhook lets you receive export files automatically without polling. When a mapping job completes, mapping.travel sends an HTTP POST to your configured endpoint with a payload containing the export file URL and job metadata.

Configure a webhook

Create a webhook config

Call POST /api/v1/export-webhooks with your endpoint URL:

curl -X POST https://api.mapping.travel/api/v1/export-webhooks \
  -H "X-API-Key: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.example.com/mapping-webhook",
    "active": true
  }'

The response includes a webhook id you can use to update or delete the config later.

Handle the webhook delivery

When a mapping job completes, mapping.travel sends a POST request to your URL. Your endpoint must return a 2xx response to acknowledge receipt.

Manage webhook configs

Endpoint	Description
`POST /api/v1/export-webhooks`	Create a new webhook config
`GET /api/v1/export-webhooks`	List all webhook configs for your organization
`GET /api/v1/export-webhooks/{id}`	Get a specific webhook config
`PUT /api/v1/export-webhooks/{id}`	Update a webhook config
`DELETE /api/v1/export-webhooks/{id}`	Delete a webhook config

Pass ?activeOnly=true to GET /api/v1/export-webhooks to list only enabled configs.

You can configure multiple webhook endpoints. mapping.travel calls all active webhooks when a job completes.

Export format configuration

You can control the shape of every export file your organization receives. Use PUT /api/v1/export-format to set or update your format preferences:

curl -X PUT https://api.mapping.travel/api/v1/export-format \
  -H "X-API-Key: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "format": "csv",
    "fields": ["id", "name", "referenceHotelId", "matchMethod", "matchConfidence"]
  }'

Retrieve your current format config with GET /api/v1/export-format. If no config is set, exports use the default format and field set.

Format config applies to all exports for your organization: both manual downloads and webhook deliveries. Update it before running a mapping job if you need a specific output shape.

Get Started

Core Concepts

Guides

Delivery destinations

MCP

Agents

Two ways to get results

Manual download

Export webhook

Manual export

Export webhooks

Configure a webhook

Manage webhook configs

Export format configuration

​Two ways to get results

Manual download

Export webhook

​Manual export

​Export webhooks

​Configure a webhook

​Manage webhook configs

​Export format configuration

Two ways to get results

Manual export

Export webhooks

Configure a webhook

Manage webhook configs

Export format configuration