List Voice Session Evals

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

GET /api/v1/voice-session-evals

cURL

curl --request GET \
  --url 'https://api.voice.stateset.com/api/v1/voice-session-evals' \
  --header "Authorization: Bearer $STATESET_VOICE_API_KEY"

200

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

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

Query parameters

min_score · number (double)

max_score · number (double)

tag · string

limit · integer (int64)

offset · integer (int64)

Response

object

ok · boolean · required

tenant · string · required

Tenant id the listing is scoped to

count · integer · required

Number of evaluations in this response

evaluations · object[] · required

Show evaluations

session_id · string · required

Voice session the evaluation belongs to

score · number (double) · required

Evaluation score

notes · string,null · required

Free-form evaluator notes

tags · string[] · required

source · string,null · required

Where the evaluation came from

agent_name · string,null · required

agent_key · string,null · required

agent_version_id · string,null · required

Agent version evaluated, as a UUID string

created_at · string (date-time) · required

updated_at · string (date-time) · required

Status codes

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

cURL

curl --request GET \
  --url 'https://api.voice.stateset.com/api/v1/voice-session-evals' \
  --header "Authorization: Bearer $STATESET_VOICE_API_KEY"

200

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