Upload a hotel inventory file to Mapping.Travel

Upload a CSV, JSON, Excel, or Parquet hotel inventory file to Mapping.Travel for processing. Returns an uploadId you can use to track progress.

Use this endpoint to submit a hotel inventory file for processing. Mapping.Travel accepts CSV, JSON, Excel (.xlsx), and Parquet formats up to 500MB. Once uploaded, use the returned uploadId to poll for status. Uploading the same file twice returns the same uploadId — the operation is idempotent.

Request

POST https://api.mapping.travel/api/v1/inventory

Content-Type: multipart/form-data

file · file · required

The hotel inventory file to upload. Supported formats: CSV, JSON, Excel (.xlsx), Parquet. Maximum file size is 500MB.

supplierCode · string

Optional supplier code used for ID-to-ID mapping (e.g., expedia, booking). When provided, property IDs in your file are matched against the specified supplier’s ID space.

Example

curl

curl -X POST https://api.mapping.travel/api/v1/inventory \
  -H "Authorization: Bearer <your-token>" \
  -F "file=@hotels.csv" \
  -F "supplierCode=expedia"

Response

A successful upload returns HTTP 201 Created.

uploadId · string

UUID identifying this upload record. Use this to check status, download, or cancel.

status · string

Initial status of the upload. Will be PENDING immediately after submission.

filename · string

Original filename as received by the server.

fileFormat · string

Detected file format: CSV, JSON, EXCEL, or PARQUET.

rowCount · integer

Total number of data rows detected. May be 0 until processing begins.

validRows · integer

Number of rows that passed validation. May be 0 until processing completes.

invalidRows · integer

Number of rows that failed validation. May be 0 until processing completes.

supplierCode · string

The supplier code provided in the request, if any.

createdAt · string

ISO 8601 timestamp of when the upload record was created.

Processing is asynchronous. After receiving a 201, poll GET /api/v1/inventory/{uploadId} to track progress until the status transitions to COMPLETED or FAILED.

Error codes

Code	Description
400	Invalid request — missing file, empty file, or malformed request
401	Missing or invalid Bearer token
413	File exceeds the 500MB size limit
415	Unsupported file format — only CSV, JSON, Excel (.xlsx), and Parquet are accepted
429	Rate limit exceeded — reduce upload frequency and retry