Skip to main content
GET
/
v1
/
get-call
/
{call_id}
curl https://api.voicy.co/v1/get-call/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": "ended",
  "agent_id": "550e8400-e29b-41d4-a716-446655440001",
  "from_number": "+15551234567",
  "to_number": "+15559876543",
  "direction": "outbound",
  "start_timestamp": 1704067200000,
  "end_timestamp": 1704067320000,
  "duration_ms": 120000,
  "transcript": "Agent: Hello, this is...\nUser: Hi, I'm calling about...",
  "transcript_object": [
    {"role": "agent", "content": "Hello, this is..."},
    {"role": "user", "content": "Hi, I'm calling about..."}
  ],
  "recording_url": "https://storage.voicy.co/recordings/...",
  "summary": "Customer inquiry about order status.",
  "disconnection_reason": "user_hangup",
  "metadata": {},
  "call_cost": {
    "combined_cost": 0.056,
    "currency": "usd"
  }
}
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

​
call_id
string
Unique identifier for the call.
​
call_type
string
Type of call (phone_call).
​
call_status
string
Current status: initiated, ringing, in_progress, ended, or error.
​
agent_id
string
ID of the agent that handled the call.
​
from_number
string
The caller’s phone number.
​
to_number
string
The called phone number.
​
direction
string
Call direction: inbound or outbound.
​
start_timestamp
integer
Unix timestamp (milliseconds) when the call started.
​
end_timestamp
integer
Unix timestamp (milliseconds) when the call ended.
​
duration_ms
integer
Call duration in milliseconds.
​
transcript
string
Full conversation transcript as plain text.
​
transcript_object
array
Structured transcript with speaker roles.
[
  {"role": "agent", "content": "Hello, how can I help you?"},
  {"role": "user", "content": "I have a question about my order."}
]
​
recording_url
string
Signed URL to the call recording. Expires in 1 hour.
​
summary
string
AI-generated summary of the call.
​
disconnection_reason
string
Why the call ended (e.g., user_hangup, agent_hangup, error).
​
metadata
object
Custom metadata attached to the call.
​
call_cost
object
Cost breakdown for the call.
{
  "combined_cost": 0.056,
  "currency": "usd"
}

curl https://api.voicy.co/v1/get-call/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": "ended",
  "agent_id": "550e8400-e29b-41d4-a716-446655440001",
  "from_number": "+15551234567",
  "to_number": "+15559876543",
  "direction": "outbound",
  "start_timestamp": 1704067200000,
  "end_timestamp": 1704067320000,
  "duration_ms": 120000,
  "transcript": "Agent: Hello, this is...\nUser: Hi, I'm calling about...",
  "transcript_object": [
    {"role": "agent", "content": "Hello, this is..."},
    {"role": "user", "content": "Hi, I'm calling about..."}
  ],
  "recording_url": "https://storage.voicy.co/recordings/...",
  "summary": "Customer inquiry about order status.",
  "disconnection_reason": "user_hangup",
  "metadata": {},
  "call_cost": {
    "combined_cost": 0.056,
    "currency": "usd"
  }
}