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 Spotify show URL

Response

string
Batch UUID
string
Original Spotify show URL
string
Batch status: paused, processing, completed, or finished
string
S3 folder prefix for episodes
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: