List Jobs
Task Management
List Jobs
List your jobs with pagination, status filtering, and model filtering.
GET
List Jobs
Authentication
This endpoint requires an API key with thecheck_status scope.
Query Parameters
number
default:"20"
Number of jobs to return per page. Maximum value is
100.string
Pagination cursor from a previous response’s
nextCursor field. Use this to fetch the next page of results.string
Filter jobs by status. Accepted values:
pending, processing, completed, failed, cancelled.string
Filter jobs by model slug. Example:
"google/veo-3.1-fast/text-to-video"Response
array
Array of job objects. Each job contains
jobId, status, progress, model, createdAt, and completedAt.string | null
Cursor to use for fetching the next page.
null if there are no more results.boolean
Whether there are more results available beyond this page.
Cursor-Based Pagination
This endpoint uses cursor-based pagination for efficient and consistent traversal of results. Unlike offset-based pagination, cursor-based pagination ensures you never miss or duplicate items even if new jobs are created between requests. How it works:- Make your first request without a
cursorparameter. - If
hasMoreistrue, use thenextCursorvalue from the response as thecursorparameter in your next request. - Repeat until
hasMoreisfalse.
