curl --request GET \
--url 'https://api.voice.stateset.com/api/v1/voice-sessions/{id}' \
--header "Authorization: Bearer $STATESET_VOICE_API_KEY"
{
"agent_name": "ResponseCX",
"call_sid": "CA1234567890abcdef1234567890abcdef",
"call_type": "inbound",
"created_at": "2024-01-15T10:30:00Z",
"customer_phone": "+15555555678",
"duration_ms": 142000,
"ended_at": "2024-01-15T10:32:22Z",
"function_calls": null,
"id": "550e8400-e29b-41d4-a716-446655440000",
"metadata": null,
"model": "gpt-4o-realtime-preview",
"org_id": "org-456",
"rating": 4,
"sentiment": "positive",
"started_at": "2024-01-15T10:30:00Z",
"status": "completed",
"stream_id": "MZ1234567890abcdef1234567890abcdef",
"summary": "Customer inquired about order ORD-123 status. Agent confirmed it shipped yesterday.",
"tags": [
"vip",
"escalation"
],
"tenant_id": "tenant-123",
"transcript": null,
"turn_count": 12,
"updated_at": "2024-01-15T10:32:22Z",
"vad_events": null,
"voice": "alloy"
}
Get a voice session by UUID
Returns the full voice session record including transcript, function calls, and VAD metrics.
GET
/
api
/
v1
/
voice-sessions
/
{id}
curl --request GET \
--url 'https://api.voice.stateset.com/api/v1/voice-sessions/{id}' \
--header "Authorization: Bearer $STATESET_VOICE_API_KEY"
{
"agent_name": "ResponseCX",
"call_sid": "CA1234567890abcdef1234567890abcdef",
"call_type": "inbound",
"created_at": "2024-01-15T10:30:00Z",
"customer_phone": "+15555555678",
"duration_ms": 142000,
"ended_at": "2024-01-15T10:32:22Z",
"function_calls": null,
"id": "550e8400-e29b-41d4-a716-446655440000",
"metadata": null,
"model": "gpt-4o-realtime-preview",
"org_id": "org-456",
"rating": 4,
"sentiment": "positive",
"started_at": "2024-01-15T10:30:00Z",
"status": "completed",
"stream_id": "MZ1234567890abcdef1234567890abcdef",
"summary": "Customer inquired about order ORD-123 status. Agent confirmed it shipped yesterday.",
"tags": [
"vip",
"escalation"
],
"tenant_id": "tenant-123",
"transcript": null,
"turn_count": 12,
"updated_at": "2024-01-15T10:32:22Z",
"vad_events": null,
"voice": "alloy"
}
Returns the full voice session record including transcript, function calls,
and VAD metrics.
Path parameters
Response
VoiceSession
Status codes
| Code | Meaning |
|---|---|
200 | Voice session detail |
401 | Unauthorized - invalid or missing bearer token |
404 | Voice session not found |
500 | Internal server error |
503 | Database not configured - set DATABASE_URL |
curl --request GET \
--url 'https://api.voice.stateset.com/api/v1/voice-sessions/{id}' \
--header "Authorization: Bearer $STATESET_VOICE_API_KEY"
{
"agent_name": "ResponseCX",
"call_sid": "CA1234567890abcdef1234567890abcdef",
"call_type": "inbound",
"created_at": "2024-01-15T10:30:00Z",
"customer_phone": "+15555555678",
"duration_ms": 142000,
"ended_at": "2024-01-15T10:32:22Z",
"function_calls": null,
"id": "550e8400-e29b-41d4-a716-446655440000",
"metadata": null,
"model": "gpt-4o-realtime-preview",
"org_id": "org-456",
"rating": 4,
"sentiment": "positive",
"started_at": "2024-01-15T10:30:00Z",
"status": "completed",
"stream_id": "MZ1234567890abcdef1234567890abcdef",
"summary": "Customer inquired about order ORD-123 status. Agent confirmed it shipped yesterday.",
"tags": [
"vip",
"escalation"
],
"tenant_id": "tenant-123",
"transcript": null,
"turn_count": 12,
"updated_at": "2024-01-15T10:32:22Z",
"vad_events": null,
"voice": "alloy"
}
Last modified on August 31, 2026