# List an evaluation's results

Source: https://docs.vlayers.ai/reference/agents/list-evaluation-results

`GET /v1/evaluations/{id}/results` · scope `workspace:read`

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.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The evaluation id. Example: `"0192f5f7-b0cf-7a1d-9c6d-7e8f90123456"` |
| `agentId` | query | string | no | Only results for one agent. Example: `"0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78"` |
| `since` | query | string | no | Only results updated after this ISO timestamp. Example: `"2026-10-20T15:04:05.000Z"` |
| `cursor` | query | string | no | The `nextCursor` of the previous page. Example: `"MjAyNi0xMS0xMg"` |
| `limit` | query | integer | no | How many items to return, 1–100. Default 25. Example: `20` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/evaluations/$EVALUATION_ID/results" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { results } = await voicelayer.agents.listEvaluationResults('<evaluation-id>');
console.log(results);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.agents.list_evaluation_results("<evaluation-id>")
print(result.results)
```

## Response `200`

```json
{
  "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
}
```
