Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mappingtravel.mintlify.app/llms.txt

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

Connecting a supplier enables Mapping.Travel to run ID-to-ID mappings between your hotel inventory and that supplier’s dataset. Your current billing plan determines the maximum number of suppliers you can connect simultaneously. Disconnecting removes the active connection but does not delete historical mapping results.
Both endpoints require authentication. Include your bearer token in the Authorization header for all requests.

​
POST /api/v1/suppliers//connect

Connect your organization to a supplier. 
POST https://api.mapping.travel/api/v1/suppliers/{supplierId}/connect

​
Path parameters

​
supplierId
string
required
UUID of the supplier to connect. Retrieve supplier IDs from GET /api/v1/suppliers.

​
Response

Returns 201 Created with the supplier connection details.
​
id
string
required
UUID of the newly created connection.
​
supplierId
string
required
UUID of the connected supplier.
​
supplierCode
string
required
Short code of the connected supplier.
​
supplierName
string
required
Display name of the connected supplier.
​
connectedAt
string
required
ISO 8601 timestamp of when the connection was created.

​
Errors

StatusDescription
400 Bad RequestYour plan’s maximum supplier limit has been reached, or you have hit a rate limit.
404 Not FoundNo supplier exists with the given ID.

​
Example

curl -X POST \
  "https://api.mapping.travel/api/v1/suppliers/a1b2c3d4-0000-0000-0000-000000000001/connect" \
  -H "Authorization: Bearer <token>"

{
  "id": "conn-5f6a7b8c-0000-0000-0000-000000000001",
  "supplierId": "a1b2c3d4-0000-0000-0000-000000000001",
  "supplierCode": "expedia",
  "supplierName": "Expedia",
  "connectedAt": "2026-04-25T10:30:00Z"
}
Check your current plan limits before connecting suppliers. Use GET /api/v1/billing/quota/status to see your maxSuppliers value and how many you have already connected.

​
DELETE /api/v1/suppliers//disconnect

Disconnect your organization from a supplier. 
DELETE https://api.mapping.travel/api/v1/suppliers/{supplierId}/disconnect

​
Path parameters

​
supplierId
string
required
UUID of the supplier to disconnect.

​
Response

Returns 204 No Content on success. The response body is empty.

​
Errors

StatusDescription
400 Bad RequestRate limit exceeded.
404 Not FoundYour organization is not connected to the specified supplier.

​
Example

curl -X DELETE \
  "https://api.mapping.travel/api/v1/suppliers/a1b2c3d4-0000-0000-0000-000000000001/disconnect" \
  -H "Authorization: Bearer <token>"