Skip to main content
GET
Get run turns
Returns every turn from the run, ordered by turn_number ascending. Includes:
  • persona rows — the test caller’s text
  • agent rows — the agent’s text, plus any tool_calls it issued in that turn
  • tool_result rows — synthetic-or-real tool results injected back into the agent
  • flow_event rows (flow agents only) — flow_node_entered, flow_eval_decision, flow_tool_result events mirrored from the flow runtime
Walking the turn list top-to-bottom is the canonical way to debug a failing assertion. Look for the moment the agent’s transcript diverged from what your assertion expected.

Authorizations

Authorization
string
header
required

Your Yappr API key (e.g. ypr_live_...). Generate one in the dashboard under Settings → API Keys.

Path Parameters

id
string<uuid>
required

Response

Ordered list of turns

data
object[]