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
UUID of the supplier to connect. Retrieve supplier IDs from GET /api/v1/suppliers.
Response
Returns 201 Created with the supplier connection details.
UUID of the newly created connection.
UUID of the connected supplier.
Short code of the connected supplier.
Display name of the connected supplier.
ISO 8601 timestamp of when the connection was created.
Errors
| Status | Description |
|---|
400 Bad Request | Your plan’s maximum supplier limit has been reached, or you have hit a rate limit. |
404 Not Found | No 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
UUID of the supplier to disconnect.
Response
Returns 204 No Content on success. The response body is empty.
Errors
| Status | Description |
|---|
400 Bad Request | Rate limit exceeded. |
404 Not Found | Your 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>"