See the reviews' totals for an agent

GET
/v1/agents/{id}/analyses

Totals for each enabled review over a period, from plain values only: how many conversations were reviewed, the average quality, how many checks passed. Aggregates only: no transcript and no reasoning, so a builder may read it.

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

Start of the period, an ISO timestamp. Default: 30 days ago.

Formatdate-time
until?string

End of the period, an ISO timestamp. Default: now.

Formatdate-time

Response Body

Each enabled review's totals over the period; aggregates only

application/json
  1. response
agentId*string
since*string
until*string
analyses*array<>

One entry per enabled review, as totals over the period: counts and rates, never a transcript or a reason.

Example Request
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/analyses" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",  "since": "2026-10-20T15:04:05.000Z",  "until": "2026-10-20T15:04:05.000Z",  "analyses": [    {      "analyzerId": "vl/qa",      "instanceId": "0192f5fb-f403-7e51-9a01-23456789abcd",      "label": "Quality review",      "blocks": [        {          "type": "status",          "label": "Quality 82 of 100",          "tone": "ok"        },        {          "type": "facts",          "items": [            {              "label": "Sentiment",              "value": "positive"            }          ]        }      ]    }  ]}