List Jobs
curl --request GET \
--url https://api.novita.ai/gpu-instance/openapi/v1/jobs \
--header 'Authorization: <authorization>'import requests
url = "https://api.novita.ai/gpu-instance/openapi/v1/jobs"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.novita.ai/gpu-instance/openapi/v1/jobs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.novita.ai/gpu-instance/openapi/v1/jobs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.novita.ai/gpu-instance/openapi/v1/jobs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.novita.ai/gpu-instance/openapi/v1/jobs")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.novita.ai/gpu-instance/openapi/v1/jobs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"jobs": [
{
"Id": "<string>",
"user": "<string>",
"type": "<string>",
"envs": [
{
"key": "<string>",
"value": "<string>"
}
],
"state": {
"state": "<string>",
"error": "<string>",
"errorMessage": "<string>"
},
"logAddress": "<string>",
"createdAt": "<string>",
"instanceId": "<string>"
}
]
}Jobs
List Jobs
GET
/
gpu-instance
/
openapi
/
v1
/
jobs
List Jobs
curl --request GET \
--url https://api.novita.ai/gpu-instance/openapi/v1/jobs \
--header 'Authorization: <authorization>'import requests
url = "https://api.novita.ai/gpu-instance/openapi/v1/jobs"
headers = {"Authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: '<authorization>'}};
fetch('https://api.novita.ai/gpu-instance/openapi/v1/jobs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.novita.ai/gpu-instance/openapi/v1/jobs",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.novita.ai/gpu-instance/openapi/v1/jobs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.novita.ai/gpu-instance/openapi/v1/jobs")
.header("Authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.novita.ai/gpu-instance/openapi/v1/jobs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"jobs": [
{
"Id": "<string>",
"user": "<string>",
"type": "<string>",
"envs": [
{
"key": "<string>",
"value": "<string>"
}
],
"state": {
"state": "<string>",
"error": "<string>",
"errorMessage": "<string>"
},
"logAddress": "<string>",
"createdAt": "<string>",
"instanceId": "<string>"
}
]
}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
obrigatório
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
curl --location --request GET 'https://api.novita.ai/gpu-instance/openapi/v1/jobs?pageSize=5&pageNum=1&jobId=&type=&state=&startTime=&endTime=&creators=' \
--header 'Authorization: Bearer {{API_KEY}}'
Response
object[]
obrigatório
Job list.
Ocultar properties
Ocultar properties
string
obrigatório
Job ID.
string
obrigatório
The user ID who initiated the job.
string
obrigatório
Job type. One of:
saveImage, instanceMigrate, autoInstanceMigrate.object[]
object
obrigatório
string
Log URL for viewing job execution logs.
string
obrigatório
Job creation time (Unix timestamp in seconds).
string
obrigatório
Associated instance ID when the job was executed.
Última modificação em 15 de maio de 2026