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
GET
https://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);
$response = $voiceClient->getRecordingTranscription($accountId, $callId, $recordingId);
print_r($response->getResult()->transcripts[0]->text);
print_r($response->getResult()->transcripts[0]->confidence);
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);
$response = $voiceClient->getRecordingTranscription($accountId, $callId, $recordingId);
print_r($response->getResult()->transcripts[0]->text);
print_r($response->getResult()->transcripts[0]->confidence);
print_r($response->getResult()->transcripts[1]->text);
print_r($response->getResult()->transcripts[1]->confidence);