Skip to main content
GET
/
download
/
{download_id}
Get download status/details
curl --request GET \
  --url https://api.videodb.io/download/{download_id} \
  --header 'x-access-token: <api-key>'
{
  "success": true,
  "status": "processing",
  "data": {
    "id": "job-123",
    "output_url": "https://api.videodb.io/async-response/job-123"
  }
}
Check the status of a specific download job and retrieve the final download URL when ready. Poll this endpoint to track progress. 
import requests

response = requests.get(
    "https://api.videodb.io/download/download-abc123",
    headers={"x-access-token": "your_api_key"}
)

result = response.json()
data = result.get('data', {})
print(f"Status: {data.get('status')}")
print(f"Name: {data.get('name')}")

if data.get('status') == 'done':
    print(f"Download URL: {data.get('download_url')}")
elif data.get('status') == 'error':
    print(f"Error: {data.get('error')}")
  • Status values: processing (in progress), done (ready to download), error (failed)
  • Download URLs are only available when status is done
  • URLs expire 24 hours after generation—regenerate if needed
  • Includes metadata: creation time, filename, completion status

Create Download

Start a new download job

Update Download

Retry a failed download

Authorizations

​
x-access-token
string
header
required

API key for authentication (sk-xxx format)

Path Parameters

​
download_id
string
required
Example:

"download-12345"

Response

200 - application/json

Download status

​
success
boolean
Example:

true

​
status
enum<string>
Available options:
processing,
done,
failed
Example:

"processing"

​
data
object