Skip to main content
The Calls API lets you read the calls a clinic’s AI agents handled: inbound phone calls, outbound calls, and web calls. Use it to list a clinic’s calls and to read one call in full.

List calls

Page through a clinic’s calls, with filters and sorting.

Get call

Read one call, with its summary and links to its transcript and recording.

Which keys work

Both endpoints accept any active API key. Who created the key doesn’t matter here. Send the key in the Authorization header:
See Authentication for how keys are created and what they can do.

When you need the clinic ID

  • List calls needs the clinic’s ID in the organizationId query parameter, with either kind of key. See Finding IDs.
  • Get call needs only the call’s ID. AlloMia finds the clinic from the call.

The call object

List calls returns a short version of each call. Get call returns the full version. The table shows which fields each endpoint returns. All timestamps are ISO 8601 strings in UTC, with milliseconds, for example 2026-09-30T14:20:15.482Z. Get call lists the possible values for userPrimaryIntent, userSentiment and callEndedReason, and explains how the transcript and recording links work.

When the details are ready

AlloMia saves the call as soon as it ends. The name, intent, sentiment, summaries and transcript link are added shortly after, once AlloMia has analysed the conversation. Until then, those fields are null. A call with no conversation, such as an outbound call nobody answered, never gets a summary, a transcript or a recording.

Outbound calls you started through the API

Calls you start with Create outbound call appear here like any other call, with callType set to Outbound. See Outbound calls for how to find the call record that matches your request.