Skip to main content
GET
List Jobs

Overview

Returns a paginated list of jobs with optional status filtering. Jobs are returned in reverse chronological order (newest first).

Header Parameters

string
required
Your API key for authentication

Query Parameters

integer
default:"20"
Number of jobs to return. Positive values above 100 are capped at 100; zero or negative values return 400.
integer
default:"0"
Number of jobs to skip for pagination
string
Filter by job status: pending, processing, completed, failed, warning, skipped, cancelled, cancelled_by_admin. Values are trimmed and case-insensitive; cancelledbyadmin is also accepted. An unknown value returns 400.

Response

array
Array of job objects
integer
Total matching jobs for the authenticated owner and the selected status, before pagination.
integer
Number of jobs requested
integer
Number of jobs skipped

Job Object

string
Job UUID
string
Original video URL
string
Job status: Pending, Processing, Completed, Failed, Warning, Skipped, Cancelled, CancelledByAdmin
string
S3 object key (when completed)
string
Error message (when failed)
string
Error classification (when failed): error for technical failures (rate limits, bot detection, connection issues), warning for content issues (private video, members-only, geo-blocked, unavailable)
string
Current processing step: Queued, Downloading, Muxing, Uploading, Finished
integer
Creation timestamp (milliseconds since epoch)
integer
Completion timestamp (milliseconds since epoch)
integer
File size in bytes (when completed)

Examples

Success Response

Error Responses