Skip to main content
GET
/
api
/
calls
/
{id}
Get Call
curl --request GET \
  --url https://allomia.com/api/calls/{id} \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "organizationId": "<string>",
  "callType": "<string>",
  "agentId": "<string>",
  "agentName": "<string>",
  "teamId": "<string>",
  "teamName": "<string>",
  "phoneNumber": "<string>",
  "callStartedAt": "<string>",
  "callEndedAt": "<string>",
  "callDurationSeconds": "<string>",
  "callEndedReason": "<string>",
  "userName": "<string>",
  "userPhoneNumber": "<string>",
  "userPrimaryIntent": "<string>",
  "userSentiment": "<string>",
  "callOutcome": "<string>",
  "callSummary": "<string>",
  "callSummaryFr": "<string>",
  "transcriptUrl": "<string>",
  "recordingUrl": "<string>",
  "createdAt": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.allomia.com/llms.txt

Use this file to discover all available pages before exploring further.

​
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

​
Authorization
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

​
id
string
required
The unique identifier of the call to retrieve

​
Response

​
id
string
Unique identifier for the call
​
organizationId
string
Organization ID the call belongs to
​
callType
string
Type of call: “Inbound”, “Outbound”, or “Web”
​
agentId
string
ID of the agent/assistant that handled the call
​
agentName
string
Name of the agent/assistant
​
teamId
string
ID of the team that owns the assistant. null for organizations that don’t use teams.
​
teamName
string
Name of the team that owns the assistant. null for organizations that don’t use teams.
​
phoneNumber
string
Phone number associated with the call
​
callStartedAt
string
Timestamp when the call started (ISO 8601 format: “2025-05-28T14:20:15Z”)
​
callEndedAt
string
Timestamp when the call ended (ISO 8601 format: “2025-05-28T14:23:15Z”)
​
callDurationSeconds
string
Duration of the call in seconds
​
callEndedReason
string
Reason the call ended
​
userName
string
Name of the user/patient (if available)
​
userPhoneNumber
string
Phone number of the user (if available)
​
userPrimaryIntent
string
Primary intent detected from the call
​
userSentiment
string
Detected sentiment of the user during the call
​
callOutcome
string
AI-extracted high-level outcome of the call (e.g. appointment_confirmed, voicemail_left, transferred_to_human).
​
callSummary
string
AI-generated English summary of the call (if available)
​
callSummaryFr
string
AI-generated French (fr-CA) summary of the call. Returned alongside callSummary.
​
transcriptUrl
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.
​
recordingUrl
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.
​
createdAt
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

curl -X GET https://allomia.com/api/calls/f6a7b8c9-d0e1-2345-fabc-678901234567 \
  -H "Authorization: Bearer YOUR-API-KEY"

​
Example Response

{
  "id": "f6a7b8c9-d0e1-2345-fabc-678901234567",
  "organizationId": "a1b2c3d4-e5f6-7890-abcd-123456789012",
  "callType": "Inbound",
  "agentId": "g7b8c9d0-e1f2-3456-abcd-789012345678",
  "agentName": "Dr. Smith Assistant",
  "teamId": "t1e2a3m4-5678-9012-abcd-ef1234567890",
  "teamName": "Front Desk",
  "phoneNumber": "+15559876543",
  "callStartedAt": "2025-05-28T14:20:15Z",
  "callEndedAt": "2025-05-28T14:23:15Z",
  "callDurationSeconds": "180",
  "callEndedReason": "customer-ended-call",
  "userName": "Jane Smith",
  "userPhoneNumber": "+15551234567",
  "userPrimaryIntent": "schedule_appointment",
  "userSentiment": "positive",
  "callOutcome": "appointment_confirmed",
  "callSummary": "Patient called to schedule a follow-up appointment for next week. Appointment was scheduled for Tuesday at 2:00 PM.",
  "callSummaryFr": "La patiente a appelé pour planifier un rendez-vous de suivi la semaine prochaine. Le rendez-vous a été fixé au mardi à 14h00.",
  "transcriptUrl": "https://allomiastorageprd.blob.core.windows.net/allomia-web-app/a1b2c3d4/transcripts/transcript.txt?sv=2023-01-03&se=2025-01-01T15%3A30%3A00Z&sr=b&sp=r&sig=SECURE_SIGNATURE",
  "recordingUrl": "https://allomiastorageprd.blob.core.windows.net/allomia-web-app/a1b2c3d4/recordings/recording.wav?sv=2023-01-03&se=2025-01-01T15%3A30%3A00Z&sr=b&sp=r&sig=SECURE_SIGNATURE",
  "createdAt": "2025-05-28T14:23:45Z"
}

​
Error Responses

{
  "error": "Invalid or missing API key"
}

{
  "error": "Call not found for the provided ID"
}

{
  "error": "Internal server error occurred"
}