List an evaluation's results

GET
/v1/evaluations/{id}/results

The evaluation's results across calls and conversations, newest first. Filter by agentId; pass cursor for the next page.

Requires an API key with the workspace:read scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

id*string

The evaluation id.

Query Parameters

agentId?string

Only results for one agent.

Formatuuid
since?string

Only results updated after this ISO timestamp.

Formatdate-time
cursor?string

The nextCursor of the previous page.

Lengthlength <= 512
limit?integer

How many items to return, 1–100. Default 25.

Range1 <= value <= 100

Response Body

A page of an evaluation's results across calls and conversations

application/json
  1. response
results*array<>
nextCursor*string|null
Example Request
curl "https://api.vlayers.ai/v1/evaluations/$EVALUATION_ID/results" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "results": [    {      "subject": {        "kind": "conversation",        "conversationId": "0192f5b0-7c3e-7a51-9b2d-4e8f1a6c3d21"      },      "channel": "whatsapp",      "met": true,      "method": "judge",      "status": "scored",      "refusalCode": null,      "coversThrough": "2026-10-20T15:04:05.000Z",      "agentVersionIds": [        "0192f5d5-9cad-7ebf-9a4b-5c6d7e8f9012"      ],      "conversationCostUsd": 0.04,      "scoringCostUsd": 0.0031,      "reasoning": "The contact confirmed the booking and the agent repeated the time.",      "updatedAt": "2026-10-20T15:04:05.000Z",      "evaluationId": "0192f5f7-b0cf-7a1d-9c6d-7e8f90123456",      "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",      "valueNumber": null,      "valueText": null    }  ],  "nextCursor": null}