curl --request GET \
--url https://api.arize.com/v2/tasks/{task_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.arize.com/v2/tasks/{task_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.arize.com/v2/tasks/{task_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.arize.com/v2/tasks/{task_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: 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.arize.com/v2/tasks/{task_id}"
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.arize.com/v2/tasks/{task_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.arize.com/v2/tasks/{task_id}")
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{
"id": "T25saW5lVGFzazo0NTpxUndY",
"name": "Production Hallucination Check",
"type": "TEMPLATE_EVALUATION",
"project_id": "TW9kZWw6MTIzOmFCY0Q=",
"dataset_id": null,
"sampling_rate": 1,
"is_continuous": true,
"query_filter": null,
"evaluators": [
{
"evaluator_id": "RXZhbHVhdG9yOjEyOmFCY0Q=",
"evaluator_name": "Hallucination Eval",
"evaluator_version_id": null,
"query_filter": null,
"column_mappings": {
"input": "attributes.input.value",
"output": "attributes.output.value"
}
}
],
"experiment_ids": [],
"last_run_at": "2026-03-01T14:30:00.000Z",
"created_at": "2026-02-20T10:00:00.000Z",
"updated_at": "2026-02-20T10:00:00.500Z",
"created_by_user_id": "VXNlcjoxOm5OYkM="
}{
"status": 400,
"title": "Invalid request parameters",
"detail": "The 'name' field is required and must be a non-empty string.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#invalid-request"
}{
"status": 401,
"title": "Authentication required",
"detail": "You must be authenticated to access this resource.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#authentication-required"
}{
"status": 404,
"title": "Resource not found",
"detail": "The requested resource with ID '12345' was not found.",
"instance": "/resource/12345",
"type": "https://arize.com/docs/ax/rest-reference/errors#resource-not-found"
}{
"status": 429,
"title": "Rate limit exceeded",
"detail": "You have exceeded the allowed number of requests. Please try again later.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#rate-limit-exceeded"
}Get task
Returns a single task by its ID.
curl --request GET \
--url https://api.arize.com/v2/tasks/{task_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.arize.com/v2/tasks/{task_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.arize.com/v2/tasks/{task_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.arize.com/v2/tasks/{task_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: 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.arize.com/v2/tasks/{task_id}"
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.arize.com/v2/tasks/{task_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.arize.com/v2/tasks/{task_id}")
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{
"id": "T25saW5lVGFzazo0NTpxUndY",
"name": "Production Hallucination Check",
"type": "TEMPLATE_EVALUATION",
"project_id": "TW9kZWw6MTIzOmFCY0Q=",
"dataset_id": null,
"sampling_rate": 1,
"is_continuous": true,
"query_filter": null,
"evaluators": [
{
"evaluator_id": "RXZhbHVhdG9yOjEyOmFCY0Q=",
"evaluator_name": "Hallucination Eval",
"evaluator_version_id": null,
"query_filter": null,
"column_mappings": {
"input": "attributes.input.value",
"output": "attributes.output.value"
}
}
],
"experiment_ids": [],
"last_run_at": "2026-03-01T14:30:00.000Z",
"created_at": "2026-02-20T10:00:00.000Z",
"updated_at": "2026-02-20T10:00:00.500Z",
"created_by_user_id": "VXNlcjoxOm5OYkM="
}{
"status": 400,
"title": "Invalid request parameters",
"detail": "The 'name' field is required and must be a non-empty string.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#invalid-request"
}{
"status": 401,
"title": "Authentication required",
"detail": "You must be authenticated to access this resource.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#authentication-required"
}{
"status": 404,
"title": "Resource not found",
"detail": "The requested resource with ID '12345' was not found.",
"instance": "/resource/12345",
"type": "https://arize.com/docs/ax/rest-reference/errors#resource-not-found"
}{
"status": 429,
"title": "Rate limit exceeded",
"detail": "You have exceeded the allowed number of requests. Please try again later.",
"instance": "/resource",
"type": "https://arize.com/docs/ax/rest-reference/errors#rate-limit-exceeded"
}Authorizations
Most Arize AI endpoints require authentication. For those endpoints that require authentication, include your API key in the request header using the format
Service accounts may instead present an access token issued by an external identity provider (Microsoft Entra ID) when the account admin has configured that provider. Send it in the same header: Authorization: Bearer <access-token>.
Path Parameters
Response
Returns a single task object
A task is a typed, configurable unit of work that ties one or more evaluators
to a data source (project or dataset). RUN_EXPERIMENT tasks additionally
carry a run_configuration that defines the LLM, evaluator, or agent
settings for each triggered run.
Evaluation tasks (TEMPLATE_EVALUATION and CODE_EVALUATION) use one of
two mutually exclusive query-filter shapes depending on the granularity of
the data each evaluator processes:
- Span shape —
query_filter(task-level) plus per-evaluatorcolumn_mappings/query_filter. For tasks where each evaluated unit is a single span.query_filtersis null. - Trace/session shape —
query_filters(namedfiltersplus optionalexpression) at the task level, and per-evaluatorquery_mappings. For tasks where each evaluated unit is a complete trace or session.query_filteris null.
All evaluators on a task must use the same shape; mixing shapes returns 400.
DECISION_JUDGE_EVALUATION tasks always use the span shape and always have
a project_id.
The task type.
- TEMPLATE_EVALUATION - An LLM template-based evaluation task.
- CODE_EVALUATION - A code-based evaluation task.
- RUN_EXPERIMENT - A task that runs experiments.
- DECISION_JUDGE_EVALUATION - A task that runs Decision Judge evaluators on
the spans of a project.
GET /v2/tasksreturns these tasks only whentype=DECISION_JUDGE_EVALUATIONis passed.
TEMPLATE_EVALUATION, CODE_EVALUATION, RUN_EXPERIMENT, DECISION_JUDGE_EVALUATION Was this page helpful?