Skip to main content
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
required
The hotel inventory file to upload. Supported formats: CSV, JSON, Excel (.xlsx), Parquet. Maximum file size is 500MB.
​
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

​
Response

A successful upload returns HTTP 202 Accepted.
​
string
UUID identifying this upload record. Use this to check status, download, or cancel.
​
string
Initial status of the upload. Will be PENDING immediately after submission.
​
string
Original filename as received by the server.
​
string
Detected file format: CSV, JSON, EXCEL, or PARQUET.
​
integer
Total number of data rows detected. May be 0 until processing begins.
​
integer
Number of rows that passed validation. May be 0 until processing completes.
​
integer
Number of rows that failed validation. May be 0 until processing completes.
​
string
The supplier code provided in the request, if any.
​
string
ISO 8601 timestamp of when the upload record was created.
Processing is asynchronous. After receiving a 202, poll GET /api/v1/inventory/{uploadId} to track progress until the status transitions to COMPLETED or FAILED.

​
Error codes