Request Supplier

If the supplier you need is not yet on the platform, request that it be added. Submit a multipart form request with 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 more information is needed.

Authentication is required. Include your API key in the X-API-Key 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

required

The supplier’s inventory file. Accepted formats: CSV, JSON, Excel (.xlsx). The mapping.travel team uses it to assess compatibility.

string

required

Name of the supplier you are requesting (e.g. TravelClick, SiteMinder).

string

Optional description of the supplier and why you need it.

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.

string

required

UUID of the created supplier request. Use this to track status via GET /api/v1/suppliers/requests.

string

required

Name of the requested supplier as submitted.

string

required

Initial status of the request. Will be pending immediately after submission.

string

required

ISO 8601 timestamp of submission.

Errors

Status	Description
`400 Bad Request`	Missing required fields or invalid request format.
`413 Payload Too Large`	The uploaded file exceeds the size limit.
`415 Unsupported Media Type`	The file format is not supported. Use CSV, JSON, or Excel.

Example

curl -X POST https://api.mapping.travel/api/v1/suppliers/request \
  -H "X-API-Key: <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",
  "createdAt": "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.

Inventory

Mapping

Reference Hotels

Suppliers

Webhooks

Export

POST /api/v1/suppliers/request

Request fields

Response

Errors

Example

​POST /api/v1/suppliers/request

​Request fields

​Response

​Errors

​Example

POST /api/v1/suppliers/request

Request fields

Response

Errors

Example