> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getbutter.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Call

Get detailed information about a specific call including transcript, turns, usage statistics, and cost breakdown.

### Path Parameters

<ParamField path="call_sid" type="string" required>
  The unique identifier of the call (format: `call_` prefix + alphanumeric).
</ParamField>

### Response

<ResponseField name="success" type="boolean">
  Indicates if the request was successful.
</ResponseField>

<ResponseField name="data" type="object">
  Complete call data object.
</ResponseField>

### Call Data Fields

<ResponseField name="call_sid" type="string" required>
  Unique call identifier.
</ResponseField>

<ResponseField name="to_number" type="string" required>
  Phone number that was called (E.164 format).
</ResponseField>

<ResponseField name="from_number" type="string">
  Caller phone number.
</ResponseField>

<ResponseField name="agent_id" type="string" required>
  ID of the agent that handled the call.
</ResponseField>

<ResponseField name="agent_name" type="string">
  Name of the agent.
</ResponseField>

<ResponseField name="agent_config" type="object">
  Agent configuration used during the call (LLM model, TTS provider, temperature, etc.).
</ResponseField>

<ResponseField name="call_type" type="string">
  Type of call: `inbound`, `outbound`, or `preview`.
</ResponseField>

<ResponseField name="status" type="string">
  Current call status.
</ResponseField>

<ResponseField name="transport" type="string">
  Transport method: `twilio`, `sip`, or `webrtc`.
</ResponseField>

<ResponseField name="recording_enabled" type="boolean">
  Whether recording was enabled.
</ResponseField>

<ResponseField name="recording_url" type="string">
  S3 URL to the processed recording file.
</ResponseField>

<ResponseField name="duration_seconds" type="number">
  Call duration in seconds.
</ResponseField>

<ResponseField name="turn_count" type="number">
  Number of conversation turns.
</ResponseField>

<ResponseField name="total_cost" type="number">
  Total cost in credits.
</ResponseField>

<ResponseField name="cost_breakdown" type="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
</ResponseField>

<ResponseField name="usage" type="object">
  Usage statistics:

  * `llm`: Token usage (input\_tokens, output\_tokens, total\_tokens)
  * `tts`: Character count
  * `stt`: Audio duration in seconds
</ResponseField>

<ResponseField name="summary" type="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
</ResponseField>

<ResponseField name="errors" type="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
</ResponseField>

<ResponseField name="turns" type="array">
  Array of conversation turns with detailed events.
</ResponseField>

<ResponseField name="transcript" type="array">
  Array of transcript entries with speaker, text, and timestamps.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO8601 timestamp when the call was created.
</ResponseField>

<ResponseField name="start_time" type="string">
  ISO8601 timestamp when the call started.
</ResponseField>

<ResponseField name="end_time" type="string">
  ISO8601 timestamp when the call ended.
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "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"
    }
  }
  ```
</ResponseExample>

<Note>
  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.
</Note>