Skip to main content
GET
Get test run status

Authorizations

X-API-Key
string
header
required

API key for authentication

Path Parameters

task_id
string
required

Test run to poll for status and results

Example:

"a3b2c1d0-e5f4-3210-abcd-ef1234567890"

Query Parameters

only_failed
boolean
default:false

Return only failing test cases. Omit to return every case

compact
boolean
default:false

Return a compact response that omits heavy detail fields (results.output, results.test_case, results.judge_results, results.reasoning, evaluators.output_config), keeping only the lightweight decision fields. Omit for full detail

Response

Successful Response

task_id
string
required

Test run job ID

Required string length: 36
Example:

"a3b2c1d0-e5f4-3210-abcd-ef1234567890"

status
enum<string>
required

Current status of the run

Available options:
queued,
in_progress,
cancelled,
done,
failed
test_uuids
string[] | null

IDs of the tests this run executed, in run order

total_tests
integer | null

Total number of test cases

passed
integer | null

Number of test cases that passed

failed
integer | null

Number of test cases that failed

latency_ms
object | null

Aggregated response latency in milliseconds, as {p50, p95, p99, count}

cost
object | null

Aggregated cost as {mean, min, max, count} (USD)

total_tokens
object | null

Aggregated token usage as {mean, min, max, count}

evaluators
TestRunEvaluator · object[] | null

The evaluators used in this run. Each verdict in judge_results links to one of these by evaluator_uuid

results
TestCaseResult · object[] | null

Results for each test case

error
boolean
default:false

True if the run failed

is_public
boolean
default:false

Whether the run is shared publicly

share_token
string | null

Token for building the public share URL