Skip to main content
Use this endpoint to get a short-lived presigned URL for downloading an inventory file. The URL is generated on demand and expires after 60 seconds, so you should redirect your user or begin the download immediately after receiving it.

​
Request

GET https://api.mapping.travel/api/v1/inventory/{uploadId}/download
​
uploadId
string
required
The UUID of the upload whose file you want to download.

​
Example

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

​
Response

​
uploadId
string
UUID of the upload record.
​
filename
string
Original filename of the inventory file.
​
fileFormat
string
File format: CSV, JSON, EXCEL, or PARQUET.
​
downloadUrl
string
Presigned URL granting direct download access. No Authorization header is required when fetching this URL.
​
expiresInSeconds
integer
Time in seconds until the downloadUrl expires. Always 60.
The downloadUrl expires after 60 seconds. Do not store or cache this URL — call this endpoint each time you need to download the file.

​
Error codes

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