Skip to main content
GET
Returns a clinic’s calls, newest first by default. Each call comes in its short form. To get the summary, transcript and recording of a call, use Get call with its id. Any active API key works:
  • A clinic key can list only its own clinic’s calls. organizationId must be that clinic’s ID.
  • A partner key can list the calls of any active clinic in your partner account.

Which calls are listed

  • Only calls that lasted at least 1 second. Calls that never connected, such as an outbound call nobody answered, are left out. You can still read them with Get call if you have their ID.
  • Only calls that have ended. A call in progress shows up once it ends.

Headers

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

Query parameters

string
required
The ID of the clinic whose calls you want. See Finding IDs.
integer
default:"1"
The page to return, starting at 1. A page past the last one returns an empty calls array.
integer
default:"20"
How many calls per page, from 1 to 50.
string
Only calls of this type: Inbound, Outbound or Web. Case-sensitive. Any other value returns a 400 error.
string
Only calls handled by the agent with exactly this name. The match is exact and case-sensitive: Reception doesn’t match reception or Reception desk. It compares against the name the agent had when each call was saved.
string
Only calls that started at or after this time. Use ISO 8601 in UTC, such as 2026-09-01T00:00:00Z, or a plain date such as 2026-09-01 (midnight UTC). A time with a time zone offset, such as -05:00, can be rejected, so convert to UTC first.
string
Only calls that started at or before this time. Same format as from. to only applies when you also send from. When you send from without to, the range ends now. from must not be later than to.
string
Only calls in this length range:Encode 600+ as 600%2B in the URL. An unencoded + reads as a space. Any value not in this table is ignored, with no error.
string
Only calls with this intent, such as schedule_appointment. AlloMia lowercases the value before comparing. unknown matches calls whose intent is other. See Get call for the list of intents.
Only calls whose id, userPhoneNumber or userName contains this text. The match is partial and case-sensitive. To search by phone number, send digits only, such as 5145550187: an unencoded + reads as a space.
string
default:"desc"
The order of the results:Any other value returns a 400 error.

Response

array
The calls on this page.
object

Errors

See Errors for the error format.