curl "https://allomia.com/api/calls/9b3e0863-4b7e-4882-b516-28c377e512c7" \
-H "Authorization: Bearer sk-..."
{
"id": "9b3e0863-4b7e-4882-b516-28c377e512c7",
"organizationId": "3dd7b994-3cac-45f6-84ca-c6032411d9f4",
"callType": "Inbound",
"agentId": "34042575-74d3-4588-a3d9-8773aab96a9b",
"agentName": "Reception",
"teamId": "8a44459e-2169-4a7b-86f3-f110b71d9570",
"teamName": "Front Desk",
"phoneNumber": "+15145550123",
"callStartedAt": "2026-09-30T14:20:15.482Z",
"callEndedAt": "2026-09-30T14:23:13.168Z",
"callDurationSeconds": "177.686",
"callEndedReason": "customer-ended-call",
"userName": "Jane Smith",
"userPhoneNumber": "+15145550187",
"userPrimaryIntent": "schedule_appointment",
"userSentiment": "positive",
"callSummary": "Jane Smith called to book a follow-up appointment for next week. The appointment was booked for Tuesday at 2:00 PM.",
"callSummaryFr": "Jane Smith a appelé pour prendre un rendez-vous de suivi la semaine prochaine. Le rendez-vous a été fixé au mardi à 14 h.",
"transcriptUrl": "https://…/transcripts/…_1759242015482.txt?sv=…&se=…&sr=b&sp=r&sig=…",
"recordingUrl": "https://…/recordings/…_1759242015482.mp3?sv=…&se=…&sr=b&sp=r&sig=…",
"createdAt": "2026-09-30T14:20:16.010Z"
}
{
"error": "Call not found"
}
Calls
Get call
Returns one call in full, with its summaries and links to its transcript and recording.
GET
/
api
/
calls
/
{id}
curl "https://allomia.com/api/calls/9b3e0863-4b7e-4882-b516-28c377e512c7" \
-H "Authorization: Bearer sk-..."
{
"id": "9b3e0863-4b7e-4882-b516-28c377e512c7",
"organizationId": "3dd7b994-3cac-45f6-84ca-c6032411d9f4",
"callType": "Inbound",
"agentId": "34042575-74d3-4588-a3d9-8773aab96a9b",
"agentName": "Reception",
"teamId": "8a44459e-2169-4a7b-86f3-f110b71d9570",
"teamName": "Front Desk",
"phoneNumber": "+15145550123",
"callStartedAt": "2026-09-30T14:20:15.482Z",
"callEndedAt": "2026-09-30T14:23:13.168Z",
"callDurationSeconds": "177.686",
"callEndedReason": "customer-ended-call",
"userName": "Jane Smith",
"userPhoneNumber": "+15145550187",
"userPrimaryIntent": "schedule_appointment",
"userSentiment": "positive",
"callSummary": "Jane Smith called to book a follow-up appointment for next week. The appointment was booked for Tuesday at 2:00 PM.",
"callSummaryFr": "Jane Smith a appelé pour prendre un rendez-vous de suivi la semaine prochaine. Le rendez-vous a été fixé au mardi à 14 h.",
"transcriptUrl": "https://…/transcripts/…_1759242015482.txt?sv=…&se=…&sr=b&sp=r&sig=…",
"recordingUrl": "https://…/recordings/…_1759242015482.mp3?sv=…&se=…&sr=b&sp=r&sig=…",
"createdAt": "2026-09-30T14:20:16.010Z"
}
{
"error": "Call not found"
}
Returns one call by its ID. You don’t send the clinic’s ID: AlloMia finds the clinic from the call.
Any active API key works:
The intent, sentiment, name, summaries and transcript are added shortly after the call ends. Until then, they’re
It can also be
See Errors for the error format.
- A clinic key can read the calls of its own clinic.
- A partner key can read the calls of every active clinic in your partner account.
Headers
Path parameters
The call’s ID, a UUID. You get it from List calls.
Response
The AI agent that answered or placed the call. For a team call, the agent that took the call first.
The team’s name. For a transferred call with no team, it can hold the name of the transfer destination while
teamId is null.Length of the call in seconds, as a decimal string such as
"177.686". "0" for a call that never connected. null while the call is in progress.Why the call ended. See How a call can end.
The name of the person the agent spoke with, if it came up in the conversation. Some older calls hold the text
"null" instead of a JSON null: treat it as no name.The caller’s number for an inbound call, or the number called for an outbound call.
null for web calls.What the caller mainly wanted. Usually one of:
schedule_appointment, reschedule_appointment, cancel_appointment, general_inquiry, technical_support, billing_question, product_information, service_information, complaint, urgent_assistance, follow_up, other. Older calls can hold other values.The caller’s overall mood. Usually one of:
very_positive, positive, neutral, negative, very_negative, frustrated, confused, urgent. Older calls can hold other values.A temporary link to the transcript, a plain-text file. See Recording and transcript links.
A temporary link to the call’s audio recording. See Recording and transcript links.
null. A call with no conversation never gets them.
Recording and transcript links
- Each link is a signed, read-only download link. It works for 1 hour from the moment you request the call.
- To get a fresh link, request the call again. Each request returns new links.
- Download the file with a plain
GET. You don’t send your API key with it: the signature in the link is the permission. Treat the link like a password while it’s valid, and don’t log or share it. - The transcript is a plain-text (
.txt) file. In recent calls, each line is one turn, starting withAI:for the agent orUser:for the other person. - The recording is an audio file: MP3 for recent calls, WAV for older ones.
- A link is
nullwhen there’s no file. This happens for a call that never connected, a call with no conversation, a call whose analysis isn’t finished yet (transcript), and in rare cases when the file can’t be found. - Treat the URL as opaque. Don’t build or change it yourself.
How a call can end
callEndedReason takes one of these values:
| Value | What happened |
|---|---|
customer-ended-call | The other person hung up. |
assistant-ended-call | The AI agent ended the call. |
assistant-forwarded-call | The AI agent transferred the call to a person or another number. |
exceeded-max-duration | The call reached the agent’s maximum call length. |
silence-timed-out | The call ended after the other person stayed silent too long. |
no-caller-audio | No sound reached the agent from the other person, so it ended the call. |
no-answer | The call never connected. For an outbound call, nobody answered. |
customer-busy | The number called was busy or rejected the call. |
unassigned-number | Someone called a clinic number that has no AI agent assigned. |
unknown-error | The call ended because of an error, or AlloMia couldn’t tell why it ended. |
null, for example while the call is in progress. Older calls can carry values that aren’t in this table. Treat any value you don’t recognize as an unspecified reason.
Errors
| Status | error | When |
|---|---|---|
| 400 | Invalid Call ID format. Must be a valid UUID. | The ID isn’t a UUID. |
| 401 | Unauthorized | The key is missing, wrong or deleted. |
| 404 | Call not found | No call has this ID, or your key can’t read it. |
| 429 | Too many requests | You sent too many requests. See Rate limits. |
| 500 | An unexpected error occurred. Please try again later. | Something went wrong on AlloMia’s side. |
curl "https://allomia.com/api/calls/9b3e0863-4b7e-4882-b516-28c377e512c7" \
-H "Authorization: Bearer sk-..."
{
"id": "9b3e0863-4b7e-4882-b516-28c377e512c7",
"organizationId": "3dd7b994-3cac-45f6-84ca-c6032411d9f4",
"callType": "Inbound",
"agentId": "34042575-74d3-4588-a3d9-8773aab96a9b",
"agentName": "Reception",
"teamId": "8a44459e-2169-4a7b-86f3-f110b71d9570",
"teamName": "Front Desk",
"phoneNumber": "+15145550123",
"callStartedAt": "2026-09-30T14:20:15.482Z",
"callEndedAt": "2026-09-30T14:23:13.168Z",
"callDurationSeconds": "177.686",
"callEndedReason": "customer-ended-call",
"userName": "Jane Smith",
"userPhoneNumber": "+15145550187",
"userPrimaryIntent": "schedule_appointment",
"userSentiment": "positive",
"callSummary": "Jane Smith called to book a follow-up appointment for next week. The appointment was booked for Tuesday at 2:00 PM.",
"callSummaryFr": "Jane Smith a appelé pour prendre un rendez-vous de suivi la semaine prochaine. Le rendez-vous a été fixé au mardi à 14 h.",
"transcriptUrl": "https://…/transcripts/…_1759242015482.txt?sv=…&se=…&sr=b&sp=r&sig=…",
"recordingUrl": "https://…/recordings/…_1759242015482.mp3?sv=…&se=…&sr=b&sp=r&sig=…",
"createdAt": "2026-09-30T14:20:16.010Z"
}
{
"error": "Call not found"
}