Skip to main content
GET
https://allomia.com
/
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>",
  "phoneNumber": "<string>",
  "callStartedAt": "<string>",
  "callEndedAt": "<string>",
  "callDurationSeconds": "<string>",
  "callEndedReason": "<string>",
  "userName": "<string>",
  "userPhoneNumber": "<string>",
  "userPrimaryIntent": "<string>",
  "userSentiment": "<string>",
  "callSummary": "<string>",
  "transcriptUrl": "<string>",
  "recordingUrl": "<string>",
  "createdAt": "<string>"
}

​
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
​
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
​
callSummary
string
AI-generated summary of the call (if available)
​
transcriptUrl
string
A secure, time-limited URL to access the call transcript. This URL is pre-signed and expires after 1 hour for security. Can be used directly to download or access the transcript file.
​
recordingUrl
string
A secure, time-limited URL to access the call recording. This URL is pre-signed and expires after 1 hour for security. Can be used directly to download or stream the recording file.
​
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",
  "phoneNumber": "+15559876543",
  "callStartedAt": "2025-05-28T14:20:15Z",
  "callEndedAt": "2025-05-28T14:23:15Z",
  "callDurationSeconds": "180",
  "callEndedReason": "normal",
  "userName": "Jane Smith",
  "userPhoneNumber": "+15551234567",
  "userPrimaryIntent": "schedule_appointment",
  "userSentiment": "positive",
  "callSummary": "Patient called to schedule a follow-up appointment for next week. Appointment was scheduled for Tuesday at 2:00 PM.",
  "transcriptUrl": "https://allomiastoragelocal.blob.core.windows.net/allomia-web-app/a1b2c3d4/transcripts/transcript.json?sv=2023-01-03&se=2025-01-01T15%3A30%3A00Z&sr=b&sp=r&sig=SECURE_SIGNATURE",
  "recordingUrl": "https://allomiastoragelocal.blob.core.windows.net/allomia-web-app/a1b2c3d4/recordings/recording.mp3?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"
}