# List an agent's goal verdicts

Source: https://docs.vlayers.ai/reference/agents/list-agent-goal-verdicts

`GET /v1/agents/{id}/goal/verdicts` · scope `workspace:read`

One verdict per conversation or call, newest first, each with whether the goal was met, how it was decided (`outcome` or `judge`), what it cost and the reason in a sentence or two. Filter by `met` or `channel`; 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 agent id. Example: `"0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78"` |
| `since` | query | string | no | Only verdicts updated after this ISO timestamp. Example: `"2026-10-20T15:04:05.000Z"` |
| `met` | query | "true" \| "false" | no | Only verdicts where the goal was met (`true`) or not (`false`). Example: `"true"` |
| `channel` | query | string | no | Only one channel: `voice`, or a channel id. Example: `"voice"` |
| `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/agents/$AGENT_ID/goal/verdicts?met=false&limit=20" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

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

const voicelayer = new VoiceLayer();

const { verdicts } = await voicelayer.agents.listGoalVerdicts('<agent-id>', {
  met: 'false',
  limit: 20
});
console.log(verdicts);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.agents.list_goal_verdicts("<agent-id>", met="false", limit=20)
print(result.verdicts)
```

## Response `200`

```json
{
  "verdicts": [
    {
      "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"
    }
  ],
  "nextCursor": null
}
```
