List an agent's goal verdicts

GET
/v1/agents/{id}/goal/verdicts

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.

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 agent id.

Query Parameters

since?string

Only verdicts updated after this ISO timestamp.

Formatdate-time
met?string

Only verdicts where the goal was met (true) or not (false).

Value in"true""false"
channel?string

Only one channel: voice, or a channel id.

Length1 <= length <= 64
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 verdicts, newest first, each with its reason

application/json
  1. response
verdicts*array<>
nextCursor*string|null
Example Request
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/goal/verdicts?met=false&limit=20" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "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}