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.

If the supplier you need is not yet available on the platform, you can request it be added. You submit a multipart form request containing the supplier’s name, an optional description, an optional contact email, and a sample of the supplier’s inventory file. The Mapping.Travel team reviews the request and contacts you if further information is needed.
Authentication is required. Include your bearer token in the Authorization header.

​
POST /api/v1/suppliers/request

Submit a new supplier request. 
POST https://api.mapping.travel/api/v1/suppliers/request
Content-Type: multipart/form-data
This endpoint accepts a multipart/form-data body. The inventory file is the sample dataset from the supplier you want onboarded.

​
Request fields

​
file
file
required
The supplier’s inventory file. Accepted formats: CSV, JSON, Excel (.xlsx). The file is used by the Mapping.Travel team to assess compatibility.
​
supplierName
string
required
Name of the supplier you are requesting (e.g. TravelClick, SiteMinder).
​
description
string
Optional description of the supplier and why you need it.
​
contactEmail
string
Optional contact email. The team will use this address if they need to follow up on your request.

​
Response

Returns 202 Accepted. The request has been queued for review.
​
id
string
required
UUID of the created supplier request. Use this to track status via GET /api/v1/suppliers/requests.
​
supplierName
string
required
Name of the requested supplier as submitted.
​
status
string
required
Initial status of the request. Will be pending immediately after submission.
​
submittedAt
string
required
ISO 8601 timestamp of submission.

​
Errors

StatusDescription
400 Bad RequestMissing required fields or invalid request format.
413 Payload Too LargeThe uploaded file exceeds the size limit.
415 Unsupported Media TypeThe file format is not supported. Use CSV, JSON, or Excel.

​
Example

curl -X POST https://api.mapping.travel/api/v1/suppliers/request \
  -H "Authorization: Bearer <token>" \
  -F "file=@inventory-sample.csv" \
  -F "supplierName=TravelClick" \
  -F "description=Global CRS provider we need for our property management system" \
  -F "contactEmail=tech@yourcompany.com"

{
  "id": "req-9f1a2b3c-0000-0000-0000-000000000001",
  "supplierName": "TravelClick",
  "status": "pending",
  "submittedAt": "2026-04-25T11:00:00Z"
}
Include as representative a sample as possible in your inventory file. A broader sample helps the team assess compatibility faster and reduces back-and-forth.