Skip to main content
GET
/
v1
/
voice
/
calls
/
{call_id}
{
  "success": true,
  "call": {
    "call_id": "<string>",
    "voice_agent_id": "<string>",
    "agent_id": "<string>",
    "agent_name": "<string>",
    "agent_version": 123,
    "direction": "<string>",
    "call_type": "<string>",
    "from_number": "<string>",
    "to_number": "<string>",
    "call_status": "<string>",
    "start_timestamp": 123,
    "end_timestamp": 123,
    "duration_ms": 123,
    "disconnection_reason": "<string>",
    "user_sentiment": "<string>",
    "call_successful": true,
    "in_voicemail": true,
    "recording_url": "<string>",
    "transcript": "<string>",
    "transcript_object": [
      {
        "role": "<string>",
        "content": "<string>",
        "words": [
          {}
        ]
      }
    ],
    "call_analysis": {
      "call_summary": "<string>",
      "in_voicemail": true,
      "user_sentiment": "<string>",
      "call_successful": true,
      "custom_analysis_data": {}
    },
    "call_cost": {
      "combined_cost": 123,
      "total_duration_seconds": 123,
      "total_duration_unit_price": 123,
      "product_costs": [
        {}
      ]
    },
    "latency": {},
    "llm_token_usage": {},
    "metadata": {},
    "dynamic_variables": {},
    "data_storage_setting": "<string>",
    "opt_in_signed_url": true,
    "telephony_identifier": {}
  },
  "powered_by": "<string>"
}

​
Description

Retrieves complete call details including full transcript and recording URL. Fetches transcript from Teli Voice AI, recording URL from Teli Voice Storage.

​
Authentication

​
X-API-Key
string
required
Your Teli API key

​
Path Parameters

​
call_id
string
required
The call ID to retrieve

​
Response Fields

​
success
boolean
Whether the request was successful
​
call
object
Complete call object with all details
​
powered_by
string
Always returns “Teli”

​
Example Request

cURL
curl -X GET "https://api.teli.ai/v1/voice/calls/call_9edb137b8014366b8cf399330da" \
  -H "X-API-Key: YOUR_API_KEY"

​
Example Response

200
{
  "success": true,
  "call": {
    "call_id": "call_9edb137b8014366b8cf399330da",
    "voice_agent_id": "agent_86f826bf8f59bacd5c10ae948a",
    "direction": "outbound",
    "call_status": "ended",
    "start_timestamp": 1763586795333,
    "end_timestamp": 1763586852943,
    "duration_ms": 57610,
    "user_sentiment": "Positive",
    "call_successful": true,
    "in_voicemail": false,
    "recording_url": "https://teli-voice-recordings-prod.s3.us-west-2.amazonaws.com/recordings/call_9edb137b8014366b8cf399330da.wav",
    "transcript": "Agent: Hi, how can I help you today?\nUser: I need information about your product...",
    "transcript_object": [
      {
        "role": "agent",
        "content": "Hi, how can I help you today?",
        "words": [
          {"word": "Hi", "start": 0.7, "end": 1.3},
          {"word": "how", "start": 1.5, "end": 1.8}
        ]
      },
      {
        "role": "user",
        "content": "I need information about your product",
        "words": [...]
      }
    ],
    "call_analysis": {
      "call_summary": "The user inquired about product information and was provided with details about features and pricing.",
      "in_voicemail": false,
      "user_sentiment": "Positive",
      "call_successful": true,
      "custom_analysis_data": {}
    }
  },
  "powered_by": "Teli"
}
404 (Call Not Found)
{
  "error": "Call not found",
  "success": false,
  "powered_by": "Teli"
}
500 (Server Error)
{
  "error": "Failed to get call details",
  "success": false,
  "powered_by": "Teli"
}

​
Notes

  • Transcript is fetched from Teli Voice AI on-demand
  • Recording URL points to Teli Voice Storage (permanent storage)
  • Call must exist in your organization to be accessed
  • Access control: Regular users can only access their own calls, admins can access all org calls