Get download status
For AI agents: docs index at /docs/llms.txt; any page as Markdown by adding .md to its URL.
Poll the status of a previously-submitted download job. Once status
is COMPLETED, the response carries a downloadUrl you can fetch
the file from. If status is FAILED, an errorCode identifies
why.
Cost: Free — polling is never charged.
Authorization
Bearer token. API key issued from the dashboard, sent as Authorization: Bearer YOUR_API_KEY. Get a key at https://vidkraken.com/login.
Parameters
jobId(path, string, required)The
jobIdreturned fromPOST /download.Example:
69cfc45e8a3b4d2f9c1e0a7b.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://vidkraken.com/api/v2/download/69cfc45e8a3b4d2f9c1e0a7b" \ -H "Authorization: Bearer YOUR_API_KEY"{
"jobId": "69cfc45e8a3b4d2f9c1e0a7b",
"status": "IN_PROGRESS",
"title": "Rick Astley - Never Gonna Give You Up",
"duration": 213,
"url": "https://youtu.be/dQw4w9WgXcQ",
"format": "1080",
"language": null,
"createdAt": "2026-09-23T20:10:00Z",
"startedAt": "2026-09-23T20:10:04Z",
"completedAt": null,
"progress": {
"stage": "downloading",
"percent": 41,
"bytesDownloaded": 43500000,
"totalBytes": 102300000,
"totalBytesIsEstimate": false,
"updatedAt": "2026-09-23T20:10:19Z"
}
}{
"error": "Missing API key. Provide it as 'Bearer YOUR_API_KEY'",
"code": "UNAUTHORIZED"
}{
"error": "Download job not found",
"code": "NOT_FOUND"
}{
"error": "Failed to enqueue download job",
"code": "INTERNAL_ERROR"
}