Skip to main content
GET
List Jobs

Authentication

This endpoint requires an API key with the check_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:
  1. Make your first request without a cursor parameter.
  2. If hasMore is true, use the nextCursor value from the response as the cursor parameter in your next request.
  3. Repeat until hasMore is false.

Examples

Example Response