Get Call

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

import requests

url = "https://api.example.com/api/calls/{call_sid}"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.example.com/api/calls/{call_sid}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/calls/{call_sid}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/calls/{call_sid}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.example.com/api/calls/{call_sid}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/calls/{call_sid}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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

api

calls

{call_sid}

Get Call

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

import requests

url = "https://api.example.com/api/calls/{call_sid}"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.example.com/api/calls/{call_sid}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/calls/{call_sid}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/calls/{call_sid}"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.example.com/api/calls/{call_sid}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/calls/{call_sid}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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

string

required

The unique identifier of the call (format: call_ prefix + alphanumeric).

Response

boolean

Indicates if the request was successful.

object

Complete call data object.

Call Data Fields

string

required

Unique call identifier.

string

required

Phone number that was called (E.164 format).

string

Caller phone number.

string

required

ID of the agent that handled the call.

string

Name of the agent.

object

Agent configuration used during the call (LLM model, TTS provider, temperature, etc.).

string

Type of call: inbound, outbound, or preview.

string

Current call status.

string

Transport method: twilio, sip, or webrtc.

boolean

Whether recording was enabled.

string

S3 URL to the processed recording file.

number

Call duration in seconds.

number

Number of conversation turns.

number

Total cost in credits.

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

object

Usage statistics:

llm: Token usage (input_tokens, output_tokens, total_tokens)
tts: Character count
stt: Audio duration in seconds

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

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

array

Array of conversation turns with detailed events.

array

Array of transcript entries with speaker, text, and timestamps.

string

ISO8601 timestamp when the call was created.

string

ISO8601 timestamp when the call started.

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.

List Calls Call Recording

Introduction

Agents

Phone Numbers

Calls

Knowledge Base

Tools

Organizations

Billing

Analytics

Preview & Voice Selection

Integrations

API Keys

Get Call

Path Parameters

Response

Call Data Fields

​Path Parameters

​Response

​Call Data Fields

Path Parameters

Response

Call Data Fields