Skip to main content
GET
/
api
/
calls
/
{call_sid}
Get Call
curl --request GET \
  --url https://api.example.com/api/calls/{call_sid}
{
  "success": true,
  "data": {
    "call_sid": "call_abc123def456",
    "trace_id": "trace_xyz789",
    "to_number": "+15559876543",
    "from_number": "+15551234567",
    "agent_id": "agent_xyz789",
    "agent_name": "Sales Rep",
    "agent_config": {
      "llm_model": "gpt-4",
      "llm_provider": "openai",
      "llm_temperature": 0.7,
      "tts_provider": "elevenlabs",
      "stt_provider": "deepgram",
      "speak_first": true
    },
    "client_id": "org_123",
    "call_type": "outbound",
    "status": "completed",
    "transport": "twilio",
    "recording_enabled": true,
    "recording_url": "s3://bucket/recordings/call_abc123.wav",
    "duration_seconds": 120.5,
    "turn_count": 7,
    "total_cost": 12.35,
    "cost_breakdown": {
      "llm_input": { "cost_credits": 1.0, "units": 100 },
      "llm_output": { "cost_credits": 2.0, "units": 50 },
      "tts": { "cost_credits": 5.0, "units": 500 },
      "stt": { "cost_credits": 1.0, "units": 120 },
      "telephony": { "cost_credits": 2.0, "units": 2 }
    },
    "usage": {
      "llm": { "total_tokens": 150, "input_tokens": 100, "output_tokens": 50 },
      "tts": { "total_characters": 500 },
      "stt": { "total_duration_seconds": 120 }
    },
    "summary": {
      "end_reason": "tool_end_call",
      "interruptions": 2,
      "avg_turn_duration": 17.2,
      "total_tokens": 150,
      "total_characters": 500
    },
    "errors": {
      "error_count": 0,
      "has_fatal_errors": false,
      "errors": []
    },
    "turns": [
      {
        "turn_number": 1,
        "relative_start_time": 0,
        "relative_end_time": 25.3,
        "duration_seconds": 25.3,
        "events": [
          {
            "type": "assistant_response",
            "text": "Hello! How can I help you today?",
            "relative_time": 0,
            "metadata": { "llm": { "total_tokens": 25, "ttfb": 0.5 } }
          }
        ]
      }
    ],
    "transcript": [
      {
        "turn": 1,
        "speaker": "assistant",
        "text": "Hello! How can I help you today?",
        "relative_time": 0,
        "timestamp": "2026-03-09T10:00:00Z"
      }
    ],
    "created_at": "2026-03-09T10:00:00Z",
    "start_time": "2026-03-09T10:00:05Z",
    "end_time": "2026-03-09T10:02:25Z"
  }
}
Get detailed information about a specific call including transcript, turns, usage statistics, and cost breakdown.

​
Path Parameters

​
call_sid
string
required
The unique identifier of the call (format: call_ prefix + alphanumeric).

​
Response

​
success
boolean
Indicates if the request was successful.
​
data
object
Complete call data object.

​
Call Data Fields

​
call_sid
string
required
Unique call identifier.
​
to_number
string
required
Phone number that was called (E.164 format).
​
from_number
string
Caller phone number.
​
agent_id
string
required
ID of the agent that handled the call.
​
agent_name
string
Name of the agent.
​
agent_config
object
Agent configuration used during the call (LLM model, TTS provider, temperature, etc.).
​
call_type
string
Type of call: inbound, outbound, or preview.
​
status
string
Current call status.
​
transport
string
Transport method: twilio, sip, or webrtc.
​
recording_enabled
boolean
Whether recording was enabled.
​
recording_url
string
S3 URL to the processed recording file.
​
duration_seconds
number
Call duration in seconds.
​
turn_count
number
Number of conversation turns.
​
total_cost
number
Total cost in credits.
​
cost_breakdown
object
Detailed cost breakdown by component:
  • llm_input: Input token costs
  • llm_output: Output token costs
  • tts: Text-to-speech costs
  • stt: Speech-to-text costs
  • telephony: Telephony costs
​
usage
object
Usage statistics:
  • llm: Token usage (input_tokens, output_tokens, total_tokens)
  • tts: Character count
  • stt: Audio duration in seconds
​
summary
object
Call summary metrics:
  • end_reason: Why the call ended
  • interruptions: Number of interruptions
  • avg_turn_duration: Average turn duration in seconds
  • total_tokens: Total LLM tokens used
  • total_characters: Total TTS characters
​
errors
object
Error information if any errors occurred:
  • error_count: Number of errors
  • has_fatal_errors: Whether any errors were fatal
  • errors: Array of error details
​
turns
array
Array of conversation turns with detailed events.
​
transcript
array
Array of transcript entries with speaker, text, and timestamps.
​
created_at
string
ISO8601 timestamp when the call was created.
​
start_time
string
ISO8601 timestamp when the call started.
​
end_time
string
ISO8601 timestamp when the call ended.
{
  "success": true,
  "data": {
    "call_sid": "call_abc123def456",
    "trace_id": "trace_xyz789",
    "to_number": "+15559876543",
    "from_number": "+15551234567",
    "agent_id": "agent_xyz789",
    "agent_name": "Sales Rep",
    "agent_config": {
      "llm_model": "gpt-4",
      "llm_provider": "openai",
      "llm_temperature": 0.7,
      "tts_provider": "elevenlabs",
      "stt_provider": "deepgram",
      "speak_first": true
    },
    "client_id": "org_123",
    "call_type": "outbound",
    "status": "completed",
    "transport": "twilio",
    "recording_enabled": true,
    "recording_url": "s3://bucket/recordings/call_abc123.wav",
    "duration_seconds": 120.5,
    "turn_count": 7,
    "total_cost": 12.35,
    "cost_breakdown": {
      "llm_input": { "cost_credits": 1.0, "units": 100 },
      "llm_output": { "cost_credits": 2.0, "units": 50 },
      "tts": { "cost_credits": 5.0, "units": 500 },
      "stt": { "cost_credits": 1.0, "units": 120 },
      "telephony": { "cost_credits": 2.0, "units": 2 }
    },
    "usage": {
      "llm": { "total_tokens": 150, "input_tokens": 100, "output_tokens": 50 },
      "tts": { "total_characters": 500 },
      "stt": { "total_duration_seconds": 120 }
    },
    "summary": {
      "end_reason": "tool_end_call",
      "interruptions": 2,
      "avg_turn_duration": 17.2,
      "total_tokens": 150,
      "total_characters": 500
    },
    "errors": {
      "error_count": 0,
      "has_fatal_errors": false,
      "errors": []
    },
    "turns": [
      {
        "turn_number": 1,
        "relative_start_time": 0,
        "relative_end_time": 25.3,
        "duration_seconds": 25.3,
        "events": [
          {
            "type": "assistant_response",
            "text": "Hello! How can I help you today?",
            "relative_time": 0,
            "metadata": { "llm": { "total_tokens": 25, "ttfb": 0.5 } }
          }
        ]
      }
    ],
    "transcript": [
      {
        "turn": 1,
        "speaker": "assistant",
        "text": "Hello! How can I help you today?",
        "relative_time": 0,
        "timestamp": "2026-03-09T10:00:00Z"
      }
    ],
    "created_at": "2026-03-09T10:00:00Z",
    "start_time": "2026-03-09T10:00:05Z",
    "end_time": "2026-03-09T10:02:25Z"
  }
}
The turns array contains detailed conversation events including tool calls, LLM metadata, TTS metadata, and STT metadata. The transcript array provides a simplified view with speaker and text for each turn.