curl --request GET \
--url 'https://api.voice.stateset.com/api/v1/sessions' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"ok": true,
"sessions": [
{
"agent_name": "Front Desk",
"call_type": "inbound",
"customer_phone": "+15555555678",
"escalated": false,
"escalation_target": null,
"greeting": "Thanks for calling Acme Dental.",
"org_id": "org-456",
"started_at": "2026-05-14T17:40:02Z",
"stream_sid": "MZ1234567890abcdef1234567890abcdef"
}
],
"tenant": "tenant_acme_dental"
}
List Sessions
Tenant-scoped endpoint for inspecting and controlling active realtime voice sessions.
GET
/
api
/
v1
/
sessions
curl --request GET \
--url 'https://api.voice.stateset.com/api/v1/sessions' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"ok": true,
"sessions": [
{
"agent_name": "Front Desk",
"call_type": "inbound",
"customer_phone": "+15555555678",
"escalated": false,
"escalation_target": null,
"greeting": "Thanks for calling Acme Dental.",
"org_id": "org-456",
"started_at": "2026-05-14T17:40:02Z",
"stream_sid": "MZ1234567890abcdef1234567890abcdef"
}
],
"tenant": "tenant_acme_dental"
}
Tenant-scoped endpoint for inspecting and controlling active realtime voice sessions.
Response
SessionsListResponse
boolean
required
Whether the request succeeded
SessionInfo[]
required
Active voice sessions
Show SessionInfo
Show SessionInfo
string,null
AI agent name (optional)
string,null
Type of call (inbound/outbound/sip_inbound/etc)
string,null
Customer’s phone number (optional)
boolean
required
Whether the session has been escalated to a human
string,null
Escalation target (optional)
string,null
Greeting message (optional)
string,null
Organization ID (optional)
string
required
Session start time (ISO 8601)
string
required
Unique stream SID from Twilio
string
required
Tenant identifier
Status codes
| Code | Meaning |
|---|---|
200 | List active sessions |
401 | Unauthorized - invalid or missing bearer token |
curl --request GET \
--url 'https://api.voice.stateset.com/api/v1/sessions' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"ok": true,
"sessions": [
{
"agent_name": "Front Desk",
"call_type": "inbound",
"customer_phone": "+15555555678",
"escalated": false,
"escalation_target": null,
"greeting": "Thanks for calling Acme Dental.",
"org_id": "org-456",
"started_at": "2026-05-14T17:40:02Z",
"stream_sid": "MZ1234567890abcdef1234567890abcdef"
}
],
"tenant": "tenant_acme_dental"
}