Skip to main content
GET
/
v1
/
call-get
/
{call_id}
curl https://api.voicy.co/functions/v1/call-get/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer voicy_sk_live_xxx"

{
  "call_id": "550e8400-e29b-41d4-a716-446655440000",
  "call_type": "phone_call",
  "call_status": "user_hangup",
  "agent": {
    "name": "Customer Support Agent",
    "version": 2
  },
  "from_number": "+15551234567",
  "to_number": "+15559876543",
  "direction": "outgoing",
  "start_timestamp": 1704067200000,
  "duration_ms": 120000,
  "transcript": [
    {
      "role": "agent",
      "content": "Hello, how can I help you?",
      "timestamp_ms": 0
    },
    {
      "role": "caller",
      "content": "I need help with my order",
      "timestamp_ms": 2500
    },
    {
      "role": "agent",
      "content": "Sure, I can help with that.",
      "timestamp_ms": 3200
    }
  ],
  "detected_gender": "male",
  "recording_url": "https://storage.voicy.co/recordings/...",
  "summary": "Customer inquiry about order status.",
  "vars_provided": {
    "customer_name": "John"
  },
  "vars_extracted": {
    "appointment_date": "2026-01-15"
  },
  "vars_collected": {
    "preferred_time": "morning"
  }
}
Retrieve complete details for a call, including transcript, recording URL, and summary.

​
Path Parameters

​
call_id
string
required
The unique identifier of the call (UUID format).

​
Response

Returns a Call object with the following fields:
​
call_id
string
Unique call identifier (UUID)
​
call_type
string
phone_call or web_call
​
call_status
string
Current call status (see Call for values)
​
agent
object
Agent that handled the call.
​
from_number
string
Caller’s phone number
​
to_number
string
Called phone number
​
direction
string
incoming or outgoing
​
start_timestamp
integer
Unix timestamp (ms) when the call started
​
duration_ms
integer
Call duration in milliseconds
​
transcript
array
Structured transcript. Each entry has:
​
detected_gender
string
Detected gender of the caller (male or female)
​
recording_url
string
Signed URL to the call recording (expires in 1 hour)
​
summary
string
AI-generated call summary
​
vars_provided
object
Variables provided when the call was created
​
vars_extracted
object
Variables extracted after the call by AI processing
​
vars_collected
object
Variables collected during the call in real-time by the agent
curl https://api.voicy.co/functions/v1/call-get/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer voicy_sk_live_xxx"

{
  "call_id": "550e8400-e29b-41d4-a716-446655440000",
  "call_type": "phone_call",
  "call_status": "user_hangup",
  "agent": {
    "name": "Customer Support Agent",
    "version": 2
  },
  "from_number": "+15551234567",
  "to_number": "+15559876543",
  "direction": "outgoing",
  "start_timestamp": 1704067200000,
  "duration_ms": 120000,
  "transcript": [
    {
      "role": "agent",
      "content": "Hello, how can I help you?",
      "timestamp_ms": 0
    },
    {
      "role": "caller",
      "content": "I need help with my order",
      "timestamp_ms": 2500
    },
    {
      "role": "agent",
      "content": "Sure, I can help with that.",
      "timestamp_ms": 3200
    }
  ],
  "detected_gender": "male",
  "recording_url": "https://storage.voicy.co/recordings/...",
  "summary": "Customer inquiry about order status.",
  "vars_provided": {
    "customer_name": "John"
  },
  "vars_extracted": {
    "appointment_date": "2026-01-15"
  },
  "vars_collected": {
    "preferred_time": "morning"
  }
}