Developers / Agents

List an agent's latest test runs

GET https://api.echonova.ai/v1/agents/{agentId}/test-runs

Lists the latest playground test runs of the agent, newest first. Needs the agents:read scope on the key.

Headers

Authorization string Required

Bearer, a space, then your API key, which starts with ek_. Create keys in the portal under Developers, API Keys.

Path parameters

agentId string Required

The agent id, as GET /v1/agents returned it.

Query parameters

limit integer Optional

How many of the latest test runs to return.

1 to 10default 2

Response

200 application/json Every response uses this envelope.

data object

The result.

success boolean

true for a successful call.

statusCode integer

Repeats the HTTP status.

errorMessage string or null

null on success.

Errors

Same envelope, with success false and data null. All errors

GET /v1/agents/{agentId}/test-runs

curl "https://api.echonova.ai/v1/agents/{agentId}/test-runs" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "6655a1b2c3d4e5f6a7b8c9d0",
      "kind": "chat",
      "status": "passed",
      "startedAt": "2026-11-03T10:00:00.000Z",
      "endedAt": "2026-11-03T10:01:00.000Z",
      "latencyMs": 800,
      "replyP50Ms": 700,
      "replyP95Ms": 1200,
      "turns": 4,
      "toolsTriggered": 1,
      "toolsTotal": 2,
      "plannedTurns": 2
    }
  ],
  "success": true,
  "statusCode": 200,
  "errorMessage": null
}