List an agent's goal verdicts
GET
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.
apiKeyheader
AuthorizationBearer <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.
id*stringThe agent id.
since?stringOnly verdicts updated after this ISO timestamp.
Format
date-timemet?stringOnly verdicts where the goal was met (true) or not (false).
Value in
"true""false"channel?stringOnly one channel: voice, or a channel id.
Length
1 <= length <= 64cursor?stringThe nextCursor of the previous page.
Length
length <= 512limit?integerHow many items to return, 1–100. Default 25.
Range
1 <= value <= 100A page of verdicts, newest first, each with its reason
application/json- response
verdicts*array<>nextCursor*string|nullcurl "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}