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.

After submitting an inventory file, use this endpoint to check its processing status. The upload moves through the following states: PENDING → PROCESSING → COMPLETED or FAILED. If you cancel an in-progress upload, the status becomes CANCELLED.

​
Request

GET https://api.mapping.travel/api/v1/inventory/{uploadId}
​
uploadId
string
required
The UUID of the upload, returned when you submitted the file.

​
Example

curl https://api.mapping.travel/api/v1/inventory/f47ac10b-58cc-4372-a567-0e02b2c3d479 \
  -H "Authorization: Bearer <your-token>"

​
Response

​
uploadId
string
UUID of the upload record.
​
status
string
Current processing status. One of: PENDING, PROCESSING, COMPLETED, FAILED, CANCELLED.
​
fileFormat
string
Detected file format: CSV, JSON, EXCEL, or PARQUET. Present once the file has been inspected.
​
rowCount
integer
Total number of data rows in the file. Present once processing begins.
​
validRows
integer
Number of rows that passed validation. Present once processing completes.
​
invalidRows
integer
Number of rows that failed validation. Present once processing completes.
​
createdAt
string
ISO 8601 timestamp of when the upload was submitted.
​
updatedAt
string
ISO 8601 timestamp of the most recent status update.

​
Status lifecycle

StatusMeaning
PENDINGFile received, queued for processing
PROCESSINGActively being validated and ingested
COMPLETEDProcessing finished successfully
FAILEDProcessing encountered an unrecoverable error
CANCELLEDUpload was cancelled via the cancel endpoint
Poll this endpoint at a reasonable interval — for example, every 5 seconds — rather than continuously. Large files may take several minutes to reach COMPLETED.

​
Error codes

CodeDescription
401Missing or invalid Bearer token
404No upload found for the given uploadId in your organization
429Rate limit exceeded