curl --request GET \
--url https://api.nixtla.io/v2/async/jobs \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.nixtla.io/v2/async/jobs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.nixtla.io/v2/async/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.nixtla.io/v2/async/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: Bearer <token>"
],
]);
$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.nixtla.io/v2/async/jobs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.nixtla.io/v2/async/jobs")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nixtla.io/v2/async/jobs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"jobs": [
{
"job_id": "fc-4f2a1c9e8b7d4a6f9c3e1b5d7a9f2c4e",
"task_name": "finetune",
"status": "pending",
"created_at": "<string>"
}
],
"next_page_token": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}List your team's async jobs
Lists your team’s jobs under jobs — use it to recover a job_id you no longer hold, then poll it on its task’s status endpoint or cancel it. Defaults to pending and running; pass status (repeatable) for terminal ones, which stay listed only for the orchestrator’s retention window. Page with page_size and next_page_token, continuing until that token is null rather than until a short page: a page can be short, or empty, and still have more behind it. A page_token is valid only for the status filter it was returned with. Rows are newest first, within a page and across them, so the job you just submitted is at the front of page one.
curl --request GET \
--url https://api.nixtla.io/v2/async/jobs \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.nixtla.io/v2/async/jobs"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.nixtla.io/v2/async/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.nixtla.io/v2/async/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: Bearer <token>"
],
]);
$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.nixtla.io/v2/async/jobs"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.nixtla.io/v2/async/jobs")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.nixtla.io/v2/async/jobs")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"jobs": [
{
"job_id": "fc-4f2a1c9e8b7d4a6f9c3e1b5d7a9f2c4e",
"task_name": "finetune",
"status": "pending",
"created_at": "<string>"
}
],
"next_page_token": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
HTTPBearer
Query Parameters
Job statuses to list. Repeatable. Defaults to pending and running.
pending, running, succeeded, failed, cancelled Maximum rows per page.
1 <= x <= 200next_page_token from the previous page.
4096Response
Successful Response
The body of GET /v2/async/jobs.
An object rather than a bare array, matching the rest of the v2 family, so a new field is not
a shape change.
One page of the team's jobs, newest first.
Show child attributes
Show child attributes
Cursor for the next page, or null on the last one. Page until this is null, not until a short page — a page can be short, or empty, and still have more behind it. Valid only for the status filter it was returned with.
Was this page helpful?