Calls, Transcripts and Recordings
List calls
Results are ordered newest first. Pagination is cursor based: pass pagination.next_cursor back as cursor. The time window is frozen inside the cursor, so calls that start while you page never produce duplicates or gaps. A cursor expires after 24 hours and is bound to your company.
Call item fields
Retrieve transcripts for specific calls
call_ids: 1–100 IDs; duplicates are removed.include: defaults to["transcript"].summaryreturns the AI call summary when one exists.
The response is always 200 when the request is valid; every ID gets its own result:
not_found means the ID does not exist in your company. Unknown IDs and IDs that belong to another customer are indistinguishable.
Download a recording
- Success:
200withContent-Type: audio/mpeg,Content-Length, andContent-Disposition: attachment; filename="call_A.mp3". Rangerequests are honoured (206+Content-Range), so an interrupted download can be resumed.409 RECORDING_NOT_AVAILABLEcarries the samestatusandreasonas therecordingobject in the list.404 NOT_FOUNDwhen the call is not in your company.
There are no public or pre-signed download links. Every download is authenticated with your key, encrypted in transit (TLS) and at rest, and recorded in your company’s audit trail.
Artifact objects
transcript
speaker:agent(the SimZ voice AI),user(the caller or callee),operator(a human who joined the call).offset_ms: milliseconds from the start of the recording.complete:falsewhen the utterance was interrupted.text: the whole conversation flattened asSPEAKER: textlines.
recording
path is relative to the API host; content_type and path are present only when status is available.
