List persisted voice sessions

Returns a paginated list of voice sessions stored in the database. Use the status query parameter to filter by session status (active, completed).

GET /api/v1/voice-sessions

cURL

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

200

{
  "ok": true,
  "tenant": "acme-outdoors",
  "sessions": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "stream_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "call_sid": "string",
      "org_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "customer_phone": "[phone]",
      "agent_name": "string",
      "call_type": "inbound",
      "status": "completed",
      "summary": "Two-person tent, green — replacement for damaged pole set.",
      "transcript": null,
      "rating": 1,
      "sentiment": "string",
      "tags": [],
      "turn_count": 1,
      "started_at": "2026-08-31T14:22:05Z",
      "ended_at": "2026-08-31T14:22:05Z",
      "created_at": "2026-08-31T14:22:05Z",
      "updated_at": "2026-08-31T14:22:05Z",
      "duration_ms": 8,
      "function_call_count": 1,
      "transcript_length": 1,
      "metadata": {}
    }
  ],
  "count": 2,
  "filtered_total": 49,
  "overall_total": 49,
  "status_counts": {},
  "stats": {
    "total": 102,
    "average_duration_ms": 7.5,
    "total_duration_ms": 8,
    "average_rating": 1.5
  },
  "longest_session": {}
}

Returns a paginated list of voice sessions stored in the database. Use the status query parameter to filter by session status (active, completed).

Query parameters

status · string

Filter by status (active, completed, transferred, failed)

search · string

Case-insensitive search across phone, agent, summary, and transcript

started_after · string

Return only sessions started after the given RFC3339 timestamp

sort · string

Sort by started_at asc or desc

limit · integer (int64)

Maximum results (default 50, max 200)

offset · integer (int64)

Pagination offset

Response

object

ok · boolean · required

tenant · string · required

Tenant id the listing is scoped to

sessions · object[] · required

Show sessions

id · string (uuid) · required

stream_id · string · required

Media stream id of the session

call_sid · string,null · required

Twilio call SID, when the session came from a PSTN call

org_id · string,null · required

customer_phone · string,null · required

agent_name · string,null · required

call_type · string,null · required

status · string · required

summary · string,null · required

LLM-generated call summary

transcript · object · required

Transcript JSON as stored (typically an array of turn entries)

rating · integer,null · required

Caller rating, when collected

sentiment · string,null · required

tags · string[] · required

turn_count · integer · required

started_at · string (date-time) · required

ended_at · string,null (date-time) · required

created_at · string (date-time) · required

updated_at · string (date-time) · required

duration_ms · integer,null · required

Session duration in milliseconds

function_call_count · integer · required

Number of function calls made during the session

transcript_length · integer · required

Number of transcript entries

metadata · object · required

count · integer · required

Number of sessions in this page

filtered_total · integer · required

Total sessions matching the current filters

overall_total · integer · required

Total sessions for the tenant, unfiltered

status_counts · object · required

Session counts keyed by status (e.g. active, completed)

stats · object · required

Show stats

total · integer · required

average_duration_ms · number,null · required

total_duration_ms · integer,null · required

average_rating · number,null · required

longest_session · object,null · required

The longest session matching the current filters, in the same shape as sessions[] entries; null when there are no sessions

Status codes

Code	Meaning
200	List of voice sessions with filtered/overall totals, per-status counts, and aggregate stats
401	Unauthorized - invalid or missing bearer token
500	Internal server error
503	Database not configured - set DATABASE_URL

cURL

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

200

{
  "ok": true,
  "tenant": "acme-outdoors",
  "sessions": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "stream_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "call_sid": "string",
      "org_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "customer_phone": "[phone]",
      "agent_name": "string",
      "call_type": "inbound",
      "status": "completed",
      "summary": "Two-person tent, green — replacement for damaged pole set.",
      "transcript": null,
      "rating": 1,
      "sentiment": "string",
      "tags": [],
      "turn_count": 1,
      "started_at": "2026-08-31T14:22:05Z",
      "ended_at": "2026-08-31T14:22:05Z",
      "created_at": "2026-08-31T14:22:05Z",
      "updated_at": "2026-08-31T14:22:05Z",
      "duration_ms": 8,
      "function_call_count": 1,
      "transcript_length": 1,
      "metadata": {}
    }
  ],
  "count": 2,
  "filtered_total": 49,
  "overall_total": 49,
  "status_counts": {},
  "stats": {
    "total": 102,
    "average_duration_ms": 7.5,
    "total_duration_ms": 8,
    "average_rating": 1.5
  },
  "longest_session": {}
}