Skip to main content
GET
Get Batch Status

Overview

Retrieves the current status and progress of a batch download operation.

Header Parameters

string
required
Your API key for authentication

Path Parameters

string
required
The batch UUID returned from POST /jobs when submitting a supported playlist or Spotify show URL

Response

string
Batch UUID
string
Original playlist or Spotify show URL (the field retains its historical name)
string
Batch status: paused, processing, completed, or finished
string
Storage folder prefix for the batch, or null
integer
Total number of episodes in the show
integer
Number of successfully completed episodes
integer
Number of failed episodes
integer
Number of skipped episodes (e.g. audio-only Spotify episodes protected by Widevine DRM)
array
List of individual job UUIDs for each episode

Example

Status Values

Progress Calculation

A batch is finished when:

Polling Example

Success Response

Error Responses

Checking Individual Episodes

To see details about failed episodes, query individual job IDs: