Download Transcription
Retrieve the specified recording's transcription file. ⚠️ Be sure to not expose your API Credentials to end-users
If the transcribed recording was multi-channel, then there will be 2 transcripts.
The caller/called party transcript will be the first item while <PlayAudio> and <SpeakSentence> transcript will be the second item.
During a <Transfer> the A-leg transcript will be the first item while the B-leg transcript will be the second item.
Request URL
GEThttps://voice.bandwidth.com/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}/transcription
Basic Authentication
Bandwidth's Voice API leverages Basic Authentication with your Dashboard API Credentials. Read more about how Bandwidth secures endpoints in the Security & Credentials document.
Supported Parameters
| Parameter | Description |
|---|---|
| None | None |
Transcription Attributes
| Attribute | Description |
|---|---|
| text | The transcription. |
| confidence | The confidence on the recognized content, ranging from 0.0 to 1.0. |
Example 1 of 2: Download a single-channel transcription
curl -X GET \
--url "https://voice.bandwidth.com/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}/transcription" \
-u '{username}:{password}'
{
"transcripts": [
{
"text": "transcribing is easy.",
"confidence": 0.98
}
]
}
ApiResponse<TranscriptionResponse> response = controller.getRecordingTranscription(accountId, callId, recordingId);
List<Transcript> list = response.getResult().getTranscripts();
System.out.println(list.get(0).getText());
System.out.println(list.get(0).getConfidence());
var response = controller.GetRecordingTranscription(accountId, callId, recordingId);
Console.WriteLine(response.Data.Transcripts[0].Text);
Console.WriteLine(response.Data.Transcripts[0].Confidence);
response = voice_client.get_recording_transcription(account_id, call_id, recording_id)
puts response.data.transcripts[0].text
puts response.data.transcripts[0].confidence
response = voice_client.get_recording_transcription(account_id, call_id, recording_id)
print(response.body.transcripts[0].text)
print(response.body.transcripts[0].confidence)
var response = await voiceController.getRecordingTranscription(accountId, callId, recordingId);
console.log(response.transcripts[0].text);
console.log(response.transcripts[0].confidence);
// coming soon
Example 2 of 2: Download a multi-channel transcription
curl -X GET \
--url "https://voice.bandwidth.com/api/v2/accounts/{accountId}/calls/{callId}/recordings/{recordingId}/transcription" \
-u '{username}:{password}'
{
"transcripts": [
{
"text": "transcribing is easy.",
"confidence": 0.98
},
{
"text": "Please, leave a message after the beep.",
"confidence": 0.88
}
]
}
ApiResponse<TranscriptionResponse> response = controller.getRecordingTranscription(accountId, callId, recordingId);
List<Transcript> list = response.getResult().getTranscripts();
System.out.println(list.get(0).getText());
System.out.println(list.get(0).getConfidence());
System.out.println(list.get(1).getText());
System.out.println(list.get(1).getConfidence());
var response = controller.GetRecordingTranscription(accountId, callId, recordingId);
Console.WriteLine(response.Data.Transcripts[0].Text);
Console.WriteLine(response.Data.Transcripts[0].Confidence);
Console.WriteLine(response.Data.Transcripts[1].Text);
Console.WriteLine(response.Data.Transcripts[1].Confidence);
response = voice_client.get_recording_transcription(account_id, call_id, recording_id)
puts response.data.transcripts[0].text
puts response.data.transcripts[0].confidence
puts response.data.transcripts[1].text
puts response.data.transcripts[1].confidence
response = voice_client.get_recording_transcription(account_id, call_id, recording_id)
print(response.body.transcripts[0].text)
print(response.body.transcripts[0].confidence)
print(response.body.transcripts[1].text)
print(response.body.transcripts[1].confidence)
var response = await voiceController.getRecordingTranscription(accountId, callId, recordingId);
console.log(response.transcripts[0].text);
console.log(response.transcripts[0].confidence);
console.log(response.transcripts[1].text);
console.log(response.transcripts[1].confidence);
// coming soon