Skip to main content
GET
List test runs for agent

Authorizations

X-API-Key
string
header
required

API key for authentication

Path Parameters

agent_uuid
string
required

Agent whose test runs to list

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

Query Parameters

type
enum<string> | null

Filter by run type. Omit to return both:

  • llm-unit-test: single runs of an agent's tests
  • llm-benchmark: multi-model comparisons
Available options:
llm-unit-test,
llm-benchmark
status
enum<string> | null

Filter by run status. Omit for all statuses

Available options:
queued,
in_progress,
cancelled,
done,
failed
has_failures
boolean | null

Filter by whether the run has any failing test case or model. true returns only runs with failures (or errors), false only clean runs. Omit for both

limit
integer | null

Maximum number of items to return. Omit for no limit (all items)

Required range: 1 <= x <= 1000000
offset
integer
default:0

Number of items to skip before returning results

Required range: x >= 0

Response

Successful Response

items
AgentTestRunListItem · object[]
required

The page of results

total
integer
required

Total number of items matching the query, before pagination

limit
integer | null

The applied limit (null when unbounded)

offset
integer
default:0

The applied offset