Connect and disconnect your organization from suppliers

Add or remove supplier connections for your organization. Your plan’s supplier limit controls how many active connections you can maintain at one time.

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

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

supplierId · string · required

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>"