Skip to main content
GET
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:
  • 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.
A call your key can’t read returns 404, the same as a call that doesn’t exist.

Headers

string
required
Bearer followed by your API key, for example Bearer sk-....

Path parameters

string
required
The call’s ID, a UUID. You get it from List calls.

Response

string
The call’s ID.
string
The clinic the call belongs to.
string
Inbound, Outbound or Web.
string | null
The AI agent that answered or placed the call. For a team call, the agent that took the call first.
string | null
That agent’s name when the call was saved. Renaming the agent later doesn’t change it.
string | null
The team that handled the call. null when no team was involved.
string | null
The team’s name. For a transferred call with no team, it can hold the name of the transfer destination while teamId is null.
string | null
The clinic’s AlloMia number the call came in on or went out from. null for web calls.
string | null
When the call started, in ISO 8601 UTC.
string | null
When the call ended, in ISO 8601 UTC. null while the call is in progress.
string | 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.
string | null
Why the call ended. See How a call can end.
string | null
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.
string | null
The caller’s number for an inbound call, or the number called for an outbound call. null for web calls.
string | null
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.
string | null
The caller’s overall mood. Usually one of: very_positive, positive, neutral, negative, very_negative, frustrated, confused, urgent. Older calls can hold other values.
null
Not filled in. Always null.
string | null
A summary of the call in English, 1 to 3 sentences.
string | null
The same summary in French.
string | null
A temporary link to the transcript, a plain-text file. See Recording and transcript links.
string | null
A temporary link to the call’s audio recording. See Recording and transcript links.
string
When AlloMia created the call record, in ISO 8601 UTC.
The intent, sentiment, name, summaries and transcript are added shortly after the call ends. Until then, they’re null. A call with no conversation never gets them.
  • 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 with AI: for the agent or User: for the other person.
  • The recording is an audio file: MP3 for recent calls, WAV for older ones.
  • A link is null when 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: It can also be 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

See Errors for the error format.