> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Voice Session Evals

> Tenant-scoped endpoint for persisted voice session records, stream lookup, and evaluation history.

Tenant-scoped endpoint for persisted voice session records, stream lookup, and evaluation history.

### Query parameters

<ParamField query="min_score" type="number (double)" />

<ParamField query="max_score" type="number (double)" />

<ParamField query="tag" type="string" />

<ParamField query="limit" type="integer (int64)" />

<ParamField query="offset" type="integer (int64)" />

### Response

`object`

<ResponseField name="ok" type="boolean" required />

<ResponseField name="tenant" type="string" required>
  Tenant id the listing is scoped to
</ResponseField>

<ResponseField name="count" type="integer" required>
  Number of evaluations in this response
</ResponseField>

<ResponseField name="evaluations" type="object[]" required>
  <Expandable title="evaluations">
    <ResponseField name="session_id" type="string" required>
      Voice session the evaluation belongs to
    </ResponseField>

    <ResponseField name="score" type="number (double)" required>
      Evaluation score
    </ResponseField>

    <ResponseField name="notes" type="string,null" required>
      Free-form evaluator notes
    </ResponseField>

    <ResponseField name="tags" type="string[]" required />

    <ResponseField name="source" type="string,null" required>
      Where the evaluation came from
    </ResponseField>

    <ResponseField name="agent_name" type="string,null" required />

    <ResponseField name="agent_key" type="string,null" required />

    <ResponseField name="agent_version_id" type="string,null" required>
      Agent version evaluated, as a UUID string
    </ResponseField>

    <ResponseField name="created_at" type="string (date-time)" required />

    <ResponseField name="updated_at" type="string (date-time)" required />
  </Expandable>
</ResponseField>

### Status codes

| Code  | Meaning                                  |
| ----- | ---------------------------------------- |
| `200` | List persisted voice session evaluations |
| `401` | Unauthorized                             |
| `500` | Internal server error                    |
| `503` | Database not configured                  |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.voice.stateset.com/api/v1/voice-session-evals' \
    --header "Authorization: Bearer $STATESET_VOICE_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "ok": true,
    "tenant": "acme-outdoors",
    "count": 2,
    "evaluations": [
      {
        "session_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "score": 7.5,
        "notes": "Two-person tent, green — replacement for damaged pole set.",
        "tags": [],
        "source": "string",
        "agent_name": "string",
        "agent_key": "string",
        "agent_version_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "created_at": "2026-08-31T14:22:05Z",
        "updated_at": "2026-08-31T14:22:05Z"
      }
    ]
  }
  ```
</ResponseExample>