Skip to main content
GET
List Jobs

Authentication

This endpoint requires an API key with the check_status scope.

Query Parameters

limit
number
default:"20"
Number of jobs to return per page. Maximum value is 100.
cursor
string
Pagination cursor from a previous response’s nextCursor field. Use this to fetch the next page of results.
status
string
Filter jobs by status. Accepted values: pending, processing, completed, failed, cancelled.
modelId
string
Filter jobs by model slug. Example: "google/veo-3.1-fast/text-to-video"

Response

jobs
array
Array of job objects. Each job contains jobId, status, progress, model, createdAt, and completedAt.
nextCursor
string | null
Cursor to use for fetching the next page. null if there are no more results.
hasMore
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