Get Call

GET /api/calls/{call_sid}

Get Call

cURL

curl --request GET \
  --url https://api.example.com/api/calls/{call_sid}

Response

{
  "success": true,
  "data": {
    "call_sid": "call_abc123def456",
    "trace_id": "trace_xyz789",
    "to_number": "[phone]",
    "from_number": "[phone]",
    "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.

Response

{
  "success": true,
  "data": {
    "call_sid": "call_abc123def456",
    "trace_id": "trace_xyz789",
    "to_number": "[phone]",
    "from_number": "[phone]",
    "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.