List Calls

StateSet Voice API operation.

GET /api/v1/customer/calls

cURL

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

200

{
  "ok": true,
  "count": 2,
  "calls": [
    {
      "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": "[phone]",
      "function_calls": [],
      "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": "[phone]",
      "transcript": [],
      "updated_at": "2024-01-15T10:32:22Z",
      "voice": "alloy"
    }
  ],
  "next_cursor": "string"
}

StateSet Voice API operation.

Query parameters

limit · integer (int64)

Max number of calls to return (1-100, default 50)

Response

object

ok · boolean · required

count · integer · required

Number of calls in this page

calls · CallLog[] · required

Show CallLog

answered_by · AnsweredBy,null

call_sid · string,null

Twilio call SID

created_at · string · required

When this record was created (ISO 8601)

direction · CallDirection · required

Direction of the call

duration_seconds · integer,null (int32)

Duration of the call in seconds

ended_at · string · required

When the call ended (ISO 8601)

error_message · string,null

Error message if call failed

escalated · boolean · required

Whether the call was escalated to a human

escalation_reason · string,null

Reason for escalation

from_number · string,null

Caller’s phone number (E.164 format)

function_calls · FunctionCallEntry[] · required

Functions called during the conversation

Show FunctionCallEntry

arguments · object · required

Arguments passed to the function

duration_ms · integer,null (int64)

How long the function took to execute in milliseconds

name · string · required

Name of the function called

result · object

Result returned by the function

timestamp · string · required

When the function was called (ISO 8601)

id · string · required

Unique identifier for this call log

model · string,null

AI model used

outcome · CallOutcome,null

recording_url · string,null

URL to the call recording (from Twilio)

started_at · string · required

When the call started (ISO 8601)

status · CallStatus · required

Current status of the call

stream_sid · string · required

Twilio stream SID

summary · string,null

LLM-generated summary of the call

system_prompt_key · string,null

System prompt key used

tenant_id · string · required

Tenant that owns this call

to_number · string,null

Called phone number (E.164 format)

transcript · TranscriptEntry[] · required

Full conversation transcript

Show TranscriptEntry

content · string · required

Content of the message

role · string · required

Role of the speaker: ‘user’, ‘assistant’, or ‘system’

timestamp · string · required

When this message was spoken (ISO 8601)

updated_at · string · required

When this record was last updated (ISO 8601)

voice · string,null

Voice used for TTS

next_cursor · string,null · required

Cursor for the next page; null when this page is the last one

Status codes

Code	Meaning
200	Page of the tenant’s call history, most recent first
404	Customer self-serve plane disabled

cURL

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

200

{
  "ok": true,
  "count": 2,
  "calls": [
    {
      "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": "[phone]",
      "function_calls": [],
      "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": "[phone]",
      "transcript": [],
      "updated_at": "2024-01-15T10:32:22Z",
      "voice": "alloy"
    }
  ],
  "next_cursor": "string"
}