Get outcomes
Recordings and transcripts
Fetch a finished call's transcript, a fresh signed recording URL and the post-call analysis.
On this page
Each row in a lead's calls[] carries three URLs: transcript_url, recording_url and analysis_url. They are Entrovox API paths that need your key, not public links, so no expiring URL ever sits in your logs. Fetch them once the call has ended. All three need only the read scope.
Fetch the transcript
GET
/v1/calls/{id}/transcriptreturns the turns of the call.curl https://api.entrovox.com/v1/calls/call_01J8K3Q7M2/transcript \ -H "Authorization: ApiKey $ENTROVOX_KEY"import os, requests r = requests.get( "https://api.entrovox.com/v1/calls/call_01J8K3Q7M2/transcript", headers={"Authorization": f"ApiKey {os.environ['ENTROVOX_KEY']}"}, timeout=15, ) for turn in r.json()["data"]["transcript"]: print(f"{turn['speaker']}: {turn['text']}")const res = await fetch("https://api.entrovox.com/v1/calls/call_01J8K3Q7M2/transcript", { headers: { Authorization: `ApiKey ${process.env.ENTROVOX_KEY}` }, }); const { data } = await res.json(); for (const turn of data.transcript) console.log(`${turn.speaker}: ${turn.text}`);200OK{ "data": { "call_id": "call_01J8K3Q7M2", "word_count": 412, "transcript": [ { "speaker": "agent", "text": "Hi, this is Robin, an AI assistant…", "started_at": "2026-09-10T18:02:14Z", "duration_ms": 4200 }, { "speaker": "customer", "text": "Yeah, I was looking at auto.", "started_at": "2026-09-10T18:02:19Z", "duration_ms": 1800 } ] } }speakerisagent(the AI),customer(the lead) orhuman_agent(your licensed agent after the transfer, when we have that audio).Get a fresh recording URL
GET
/v1/calls/{id}/recording-urlreturns a signed URL that is good for one hour. It covers the AI voice agent's session, and the audio after a transfer when we stored it.curl https://api.entrovox.com/v1/calls/call_01J8K3Q7M2/recording-url \ -H "Authorization: ApiKey $ENTROVOX_KEY"import os, requests r = requests.get( "https://api.entrovox.com/v1/calls/call_01J8K3Q7M2/recording-url", headers={"Authorization": f"ApiKey {os.environ['ENTROVOX_KEY']}"}, timeout=15, ) print(r.json()["data"]["url"]) # use now, do not storeconst res = await fetch("https://api.entrovox.com/v1/calls/call_01J8K3Q7M2/recording-url", { headers: { Authorization: `ApiKey ${process.env.ENTROVOX_KEY}` }, }); const { data } = await res.json(); console.log(data.url); // use now, do not store200OK{ "data": { "url": "https://storage.example.com/signed/recording.mp3?token=…", "expires_in": 3600 } }Three different answers can come back when there is no URL to return. Branch on
error.code, not on the status alone:Status error.codeMeaning What to do 404 RECORDING_NOT_FOUNDThe call has no recording: it never connected, recording was off, or no recording is available. A failed upload can sometimes be recovered later, in which case it appears on the call object. Do not poll for it. Check the call object later if you need it. 404 RECORDING_NOT_READYThe call has a recording that is still being processed. Poll again after the Retry-Afterheader (seconds). Partner subscriptions can also wait forcall.recording.ready, once webhook delivery is live.503 RECORDING_UNAVAILABLEThe recording exists but a link could not be made right now. Retry after Retry-After. Keep retrying with backoff.RECORDING_NOT_READYdoes not last forever. A recording that is still pending a few hours after the call ended is reported asRECORDING_NOT_FOUND. The full list is on the errors page.Get the analysis
GET
/v1/calls/{id}/analysisreturns the post-call record. Prefer itscall_outcomefor analytics over the attempt-leveldisposition.curl https://api.entrovox.com/v1/calls/call_01J8K3Q7M2/analysis \ -H "Authorization: ApiKey $ENTROVOX_KEY"import os, requests r = requests.get( "https://api.entrovox.com/v1/calls/call_01J8K3Q7M2/analysis", headers={"Authorization": f"ApiKey {os.environ['ENTROVOX_KEY']}"}, timeout=15, ) analysis = r.json()["data"] print(analysis["call_outcome"], analysis["call_summary"])const res = await fetch("https://api.entrovox.com/v1/calls/call_01J8K3Q7M2/analysis", { headers: { Authorization: `ApiKey ${process.env.ENTROVOX_KEY}` }, }); const { data: analysis } = await res.json(); console.log(analysis.call_outcome, analysis.call_summary);The record includes
call_outcome,outcome_confidence,outcome_reasoning,overall_sentiment,sentiment_score,dnc_detected,dnc_phrases,callback_detected,callback_datetime,wrong_number_detected,extracted_data,call_summaryandfollow_up_actions, plus timestamps.
When the media is ready
Hangup and analysis can arrive before the audio is uploaded, so a call can have a call_outcome while its recording is still pending. If the recording fetch answers RECORDING_NOT_READY, ask again after Retry-After. analysis_status on the call is pending, completed or failed.
Next steps
Back to the lead's status URL, or read how webhooks will tell you when media is ready.