Skip to main content
GET
List Jobs

API Description

Retrieve a paginated list of background jobs for GPU instances. You can filter by job ID, state, type, time range, and creators.

Request Headers

string
required
Bearer authentication format, for example: Bearer {{API Key}}.

Query Parameters

integer
Maximum number of items returned per page. Integer, value >= 0.
integer
Page number to retrieve. Integer, value >= 0.
string
Filter by job ID. String, length 0–255.
string
Filter by job state. One of: pulling (preparing), running, fail, success, break.
string
Filter by job type. One of: saveImage, instanceMigrate, autoInstanceMigrate.
integer
Start of time range (Unix timestamp in seconds). Integer, value >= 0. Default: 0.
integer
End of time range (Unix timestamp in seconds). Integer, value >= 0. Default: 0.
string
Filter by creator user ID.

cURL Example

Response

object[]
required
Job list.
Last modified on October 15, 2025