This endpoint allows you to check the status of a video download that was previously requested asynchronously. By providing the video’s external_id, along with the desired format, quality, and language, the API returns information about the current state of the download process.

When this endpoint is called, the system checks whether the download file is still being prepared or if it is already available. While the video is being processed, the API will return the status enqueued, indicating that the download is queued or in progress. During this phase, the response will also include the percentage field, which represents the current download progress, and the timeRemaining field, which indicates the estimated time remaining until the download is completed.

Once the processing is finished and the download file is available, the returned status will be ready, along with the final download URL so the video can be retrieved.

This step is essential in asynchronous download workflows, as it allows applications to safely track progress without risking timeouts or failed synchronous requests. It is especially useful for long videos or integrations that manage multiple downloads simultaneously.

By separating the download request from the status check, the platform ensures a more reliable, scalable, and controlled download experience.

200Download status

400Download not ready or invalid parameters

404Download not found

500Internal server error