Skip to main content
GET
List simulation runs

Authorizations

x-api-key
string
header
required

Query Parameters

status
enum<string> | null
Available options:
pending,
running,
completed,
failed,
cancelled,
budget_exceeded
agent_id
string<uuid> | null
channel
enum<string> | null

Filter by run modality (text or voice).

Available options:
text,
voice
q
string | null

Case-insensitive substring match on the agent, persona and scenario names, plus the run id (exact UUID, or an 8+ character id prefix). Names are matched against the current persona/scenario/agent records, while each row displays the names frozen at dispatch time, so a renamed entity is found by its new name.

Maximum string length: 255
limit
integer
default:50
Required range: 1 <= x <= 200
cursor
string | null

Response

Successful Response

items
SimulationRunResponse · object[]
required
has_more
boolean
required
next_cursor
string | null