Skip to main content
GET
/
agent-eval
/
runs
/
{id}
/
turns
Get run turns
curl --request GET \
  --url https://api.goyappr.com/agent-eval/runs/{id}/turns \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "run_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "turn_number": 1,
      "created_at": "2023-11-07T05:31:56Z",
      "text": "<string>",
      "tool_calls": [
        {}
      ],
      "flow_event": {},
      "model": "<string>",
      "input_tokens": 0,
      "output_tokens": 0,
      "cost_cents": 0,
      "latency_ms": 123
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.goyappr.com/llms.txt

Use this file to discover all available pages before exploring further.

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[]