# See the reviews' totals for an agent

Source: https://docs.vlayers.ai/reference/agents/get-agent-analyses

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

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.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The agent id. Example: `"0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78"` |
| `since` | query | string | no | Start of the period, an ISO timestamp. Default: 30 days ago. Example: `"2026-10-20T15:04:05.000Z"` |
| `until` | query | string | no | End of the period, an ISO timestamp. Default: now. Example: `"2026-10-20T15:04:05.000Z"` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/analyses" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

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

const voicelayer = new VoiceLayer();

const { analyses } = await voicelayer.agents.getAnalyses('<agent-id>');
console.log(analyses);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.agents.get_analyses("<agent-id>")
print(result.analyses)
```

## Response `200`

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