Skip to main content
GET
Get Call

Get Call

Retrieves detailed information for a specific call by ID. This endpoint can be accessed using either a tenant API key or an organization API key. When using an organization API key, you can only access calls that belong to that specific organization.

Headers

string
required
API key is required. Enter either your tenant-specific or organization-specific API key in the format ‘Bearer YOUR-API-KEY’

Path Parameters

string
required
The unique identifier of the call to retrieve

Response

string
Unique identifier for the call
string
Organization ID the call belongs to
string
Type of call: “Inbound”, “Outbound”, or “Web”
string
ID of the agent/assistant that handled the call
string
Name of the agent/assistant
string
ID of the team that owns the assistant. null for organizations that don’t use teams.
string
Name of the team that owns the assistant. null for organizations that don’t use teams.
string
Phone number associated with the call
string
Timestamp when the call started (ISO 8601 format: “2025-05-28T14:20:15Z”)
string
Timestamp when the call ended (ISO 8601 format: “2025-05-28T14:23:15Z”)
string
Duration of the call in seconds
string
Reason the call ended
string
Name of the user/patient (if available)
string
Phone number of the user (if available)
string
Primary intent detected from the call
string
Detected sentiment of the user during the call
string
AI-extracted high-level outcome of the call (e.g. appointment_confirmed, voicemail_left, transferred_to_human).
string
AI-generated English summary of the call (if available)
string
AI-generated French (fr-CA) summary of the call. Returned alongside callSummary.
string
A secure, time-limited URL to the plain-text transcript (.txt). The URL is pre-signed and expires after 1 hour. Re-fetch the call to obtain a fresh URL.
string
A secure, time-limited URL to the call recording (audio file from the voice provider). The URL is pre-signed and expires after 1 hour. Re-fetch the call to obtain a fresh URL.
string
When the call record was created (ISO 8601 format: “2025-05-28T14:23:45Z”)

Security Features

  • Pre-signed URLs: The transcriptUrl and recordingUrl are automatically generated as secure, signed URLs
  • Time-limited Access: URLs expire after 1 hour for security
  • Authentication Required: API key required to get the URLs
  • Organization Isolation: Users can only access calls from their authorized organizations

Example Request

Example Response

Error Responses