Skip to main content
Check an inventory file’s processing status. The upload moves through these states: PENDINGPROCESSINGCOMPLETED or FAILED. Cancelling an in-progress upload sets the status to CANCELLED.

Request

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

Example

Response

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

Status lifecycle

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