Calls
Get a call recording (audio + transcription)
Returns the audio recording for a completed call along with any available transcription. The shape depends on the provider: Twilio recordings are fetched server-side and returned as a base64 audioData blob; Sinch / ElevenLabs / external recordings are returned as a signed audioUrl (S3 or R2). Transcriptions are lazy-fetched/transformed on first read and cached on the Call document.
Authorization
bearerAuth AuthorizationBearer <token>
In: header
Path Parameters
callId*string
The provider-agnostic callId minted by Tether (also used as providerCallId for SDK calls).
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/calls/string/recording"{ "success": true, "audioUrl": "https://example-r2.signed/.../recording.mp3?X-Amz-Expires=600", "duration": 154, "recordingId": "rec_abc123", "transcriptionText": "Agent: Hi, this is Alex from Example Corp...", "transcriptionData": [ { "role": "agent", "message": "Hi, this is Alex from Example Corp.", "timestamp": 0.5 }, { "role": "user", "message": "Hey Alex.", "timestamp": 2.8 } ], "direction": "outbound", "from": "+14165550100", "to": "+14165550199"}