Get Call Recording
Redirect to the call’s audio: one stereo Ogg/Opus file.
The redirect goes to object storage and expires within the hour, so follow
it straight away rather than storing it. It supports Range, which is what
lets a player seek without downloading the whole call first. Pass
download=true for a link that saves as call-{id}.ogg.
The caller is the left channel and the agent is the right, so you can listen
to either side alone by splitting the channels — one ffmpeg -map_channel
away, and what makes the file useful both for hearing the call and for
building training data. It is what the agent heard after noise cancellation,
not a capture of the phone line, and it does not include background audio,
which the agent publishes as its own track.
A 404 here means there is nothing to play, and its message says why — the
agent had recording off, the call is still running, the recording was
deleted by a person or by your retention policy, the caller asked not to be
recorded, or it failed to save. Check recording.state on the call first to
know which without a round trip; get_call also returns ready-made
recording.url and recording.download_url links.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Query Parameters
serve as a file named call-{id}.ogg rather than inline
Response
The audio, once the redirect above has been followed
The response is of type file.