curl --request GET \
--url 'https://api.voice.stateset.com/api/v1/call-logs/{id}' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"call": {
"answered_by": "human",
"call_sid": "CA1234567890abcdef1234567890abcdef",
"created_at": "2024-01-15T10:30:00Z",
"direction": "inbound",
"duration_seconds": 142,
"ended_at": "2024-01-15T10:32:22Z",
"error_message": "WebSocket connection closed unexpectedly",
"escalated": false,
"escalation_reason": "Customer requested to speak with a human agent",
"from_number": "+15555555678",
"function_calls": [
{
"arguments": null,
"duration_ms": null,
"name": null,
"result": null,
"timestamp": null
}
],
"id": "550e8400-e29b-41d4-a716-446655440000",
"model": "gpt-4o-realtime-preview",
"outcome": "answered",
"recording_url": "https://api.twilio.com/2010-04-01/Accounts/AC123/Recordings/RE456.json",
"started_at": "2024-01-15T10:30:00Z",
"status": "in_progress",
"stream_sid": "MZ1234567890abcdef1234567890abcdef",
"summary": "Customer called to check order status for order #12345. Agent confirmed the order shipped yesterday.",
"system_prompt_key": "default",
"tenant_id": "tenant-123",
"to_number": "+15555551234",
"transcript": [
{
"content": null,
"role": null,
"timestamp": null
}
],
"updated_at": "2024-01-15T10:32:22Z",
"voice": "alloy"
},
"ok": true
}
Get a single call log by ID
Returns the full call log including transcript and function calls.
GET
/
api
/
v1
/
call-logs
/
{id}
curl --request GET \
--url 'https://api.voice.stateset.com/api/v1/call-logs/{id}' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"call": {
"answered_by": "human",
"call_sid": "CA1234567890abcdef1234567890abcdef",
"created_at": "2024-01-15T10:30:00Z",
"direction": "inbound",
"duration_seconds": 142,
"ended_at": "2024-01-15T10:32:22Z",
"error_message": "WebSocket connection closed unexpectedly",
"escalated": false,
"escalation_reason": "Customer requested to speak with a human agent",
"from_number": "+15555555678",
"function_calls": [
{
"arguments": null,
"duration_ms": null,
"name": null,
"result": null,
"timestamp": null
}
],
"id": "550e8400-e29b-41d4-a716-446655440000",
"model": "gpt-4o-realtime-preview",
"outcome": "answered",
"recording_url": "https://api.twilio.com/2010-04-01/Accounts/AC123/Recordings/RE456.json",
"started_at": "2024-01-15T10:30:00Z",
"status": "in_progress",
"stream_sid": "MZ1234567890abcdef1234567890abcdef",
"summary": "Customer called to check order status for order #12345. Agent confirmed the order shipped yesterday.",
"system_prompt_key": "default",
"tenant_id": "tenant-123",
"to_number": "+15555551234",
"transcript": [
{
"content": null,
"role": null,
"timestamp": null
}
],
"updated_at": "2024-01-15T10:32:22Z",
"voice": "alloy"
},
"ok": true
}
Returns the full call log including transcript and function calls.
Path parameters
string (uuid)
required
Call log ID
Response
CallLogDetailResponse
CallLog
required
Full call record
Show CallLog
Show CallLog
AnsweredBy,null
string,null
Twilio call SID
string
required
When this record was created (ISO 8601)
CallDirection
required
Direction of the call
integer,null (int32)
Duration of the call in seconds
string
required
When the call ended (ISO 8601)
string,null
Error message if call failed
boolean
required
Whether the call was escalated to a human
string,null
Reason for escalation
string,null
Caller’s phone number (E.164 format)
FunctionCallEntry[]
required
Functions called during the conversation
string
required
Unique identifier for this call log
string,null
AI model used
CallOutcome,null
string,null
URL to the call recording (from Twilio)
string
required
When the call started (ISO 8601)
CallStatus
required
Current status of the call
string
required
Twilio stream SID
string,null
LLM-generated summary of the call
string,null
System prompt key used
string
required
Tenant that owns this call
string,null
Called phone number (E.164 format)
TranscriptEntry[]
required
string
required
When this record was last updated (ISO 8601)
string,null
Voice used for TTS
boolean
required
Whether the request succeeded
Status codes
| Code | Meaning |
|---|---|
200 | Call log detail |
401 | Unauthorized |
404 | Call log not found |
500 | Internal server error |
503 | Call logging is not configured |
curl --request GET \
--url 'https://api.voice.stateset.com/api/v1/call-logs/{id}' \
--header 'Authorization: Bearer YOUR_API_KEY'
{
"call": {
"answered_by": "human",
"call_sid": "CA1234567890abcdef1234567890abcdef",
"created_at": "2024-01-15T10:30:00Z",
"direction": "inbound",
"duration_seconds": 142,
"ended_at": "2024-01-15T10:32:22Z",
"error_message": "WebSocket connection closed unexpectedly",
"escalated": false,
"escalation_reason": "Customer requested to speak with a human agent",
"from_number": "+15555555678",
"function_calls": [
{
"arguments": null,
"duration_ms": null,
"name": null,
"result": null,
"timestamp": null
}
],
"id": "550e8400-e29b-41d4-a716-446655440000",
"model": "gpt-4o-realtime-preview",
"outcome": "answered",
"recording_url": "https://api.twilio.com/2010-04-01/Accounts/AC123/Recordings/RE456.json",
"started_at": "2024-01-15T10:30:00Z",
"status": "in_progress",
"stream_sid": "MZ1234567890abcdef1234567890abcdef",
"summary": "Customer called to check order status for order #12345. Agent confirmed the order shipped yesterday.",
"system_prompt_key": "default",
"tenant_id": "tenant-123",
"to_number": "+15555551234",
"transcript": [
{
"content": null,
"role": null,
"timestamp": null
}
],
"updated_at": "2024-01-15T10:32:22Z",
"voice": "alloy"
},
"ok": true
}