Checking Job Status

curl --request GET \
  --url https://api.sutro.sh/job-status/{job_id} \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.sutro.sh/job-status/{job_id}', 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.sutro.sh/job-status/{job_id}",
  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.sutro.sh/job-status/{job_id}"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.sutro.sh/job-status/{job_id}")

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

{
  "message": "Job completed successfully",
  "job_status": "succeeded",
  "metadata": {}
}

{
  "message": "Job is currently running",
  "job_status": "running",
  "metadata": {}
}

{
  "message": "Job failed during initialization",
  "job_status": "failed",
  "metadata": {
    "failure_reason": "Invalid model specified",
    "additional_context": "Model 'invalid-model' not found in available models list"
  }
}

GET

job-status

{job_id}

Checking Job Status

curl --request GET \
  --url https://api.sutro.sh/job-status/{job_id} \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.sutro.sh/job-status/{job_id}', 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.sutro.sh/job-status/{job_id}",
  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.sutro.sh/job-status/{job_id}"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.sutro.sh/job-status/{job_id}")

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

{
  "message": "Job completed successfully",
  "job_status": "succeeded",
  "metadata": {}
}

{
  "message": "Job is currently running",
  "job_status": "running",
  "metadata": {}
}

{
  "message": "Job failed during initialization",
  "job_status": "failed",
  "metadata": {
    "failure_reason": "Invalid model specified",
    "additional_context": "Model 'invalid-model' not found in available models list"
  }
}

Using the API directly is not recommended for most users. Instead, we recommend using the Python SDK.

Retrieve the status of a batch inference job by its job_id.

Request Parameters

string

required

The job_id returned when you submitted the batch inference job

Headers

string

required

Your Sutro API key using Key authentication scheme.Format: Key YOUR_API_KEYExample: Authorization: Key sk_live_abc123...

Response

Returns the current status and details of the batch inference job.

string

Message describing the job’s current status

string

The current status of the job. See status values below

object

Additional information about the job. If the status is failed during job initialization, will contain a failure_reason key with details about the failure, and optionally an additional_context key with debugging information

Job Status Values

The job_status field will be one of the following:

succeeded: The job completed successfully
failed: The job failed
cancelled: The job was cancelled
pending: The job is still pending
submitted: The job has been submitted
starting: The job is starting
running: The job is running
unknown: The job status is unknown

{
  "message": "Job completed successfully",
  "job_status": "succeeded",
  "metadata": {}
}

{
  "message": "Job is currently running",
  "job_status": "running",
  "metadata": {}
}

{
  "message": "Job failed during initialization",
  "job_status": "failed",
  "metadata": {
    "failure_reason": "Invalid model specified",
    "additional_context": "Model 'invalid-model' not found in available models list"
  }
}

Code Examples

import requests

job_id = "batch_job_12345"

response = requests.get(
    f'https://api.sutro.sh/job-status/{job_id}',
    headers={
        'Authorization': 'Key YOUR_SUTRO_API_KEY'
    }
)

result = response.json()
print(f"Job Status: {result['job_status']}")
print(f"Message: {result['message']}")

if result['job_status'] == 'failed':
    print(f"Failure Reason: {result['metadata'].get('failure_reason', 'Unknown')}")

const jobId = 'batch_job_12345';

const response = await fetch(`https://api.sutro.sh/job-status/${jobId}`, {
  method: 'GET',
  headers: {
    'Authorization': 'Key YOUR_SUTRO_API_KEY'
  }
});

const result = await response.json();
console.log(`Job Status: ${result.job_status}`);
console.log(`Message: ${result.message}`);

if (result.job_status === 'failed') {
  console.log(`Failure Reason: ${result.metadata?.failure_reason || 'Unknown'}`);
}

curl -X GET https://api.sutro.sh/job-status/batch_job_12345 \
  -H "Authorization: Key YOUR_SUTRO_API_KEY"

Functions API

Batch API

Checking Job Status

Request Parameters

Headers

Response

Job Status Values

Code Examples

​Request Parameters

​Headers

​Response

​Job Status Values

​Code Examples

Request Parameters

Headers

Response

Job Status Values

Code Examples