DokumentationEngagement Platform API
Sign inGet started
Guides
API

Get a Transcription

In order to retrieve a transcription metada, you can use the following endpoint.
GET
/workspaces/{workspaceId}/transcriptions/{transcriptionId}
Get transcription
Antwort-Payload
id
string
erforderlich
The ID for the transcription.
recordingId
string
erforderlich
The ID for the recording.
status
string
erforderlich
Possible values: accepted, ongoing, available, absent, failed
stereo
boolean
erforderlich
locale
string
erforderlich
Curated set of BCP47 locale identifiers supported by Bird speech-to-text products
Possible values: ar-AE, ar-SA, cmn-CN, cy-GB, da-DK, de-CH, de-DE, el-GR, en-AU, en-GB, en-GB-WLS, en-IE, en-IN, en-NZ, en-US, en-ZA, es-ES, es-MX, es-US, fr-CA, fr-FR, he-IL, hi-IN, id-ID, is-IS, it-IT, ja-JP, ko-KR, ms-MY, nb-NO, nl-NL, pl-PL, pt-BR, pt-PT, ro-RO, ru-RU, sv-SE, ta-IN, te-IN, th-TH, tr-TR, vi-VN, zh-CN, zh-HK, zh-TW, arb, af-ZA, bn-IN, ca-ES, cmn-TW, cs-CZ, fi-FI, fil-PH, gu-IN, hu-HU, kn-IN, lt-LT, lv-LV, ml-IN, mr-IN, pa-IN, sk-SK, sr-RS, uk-UA, yue-HK, no-NO
url
string
summary
string
createdAt
string
erforderlich
updatedAt
string
erforderlich
Codebeispiel
curl -X GET 'https://api.bird.com/workspaces/{workspaceId}/transcriptions/{transcriptionId}' \
  -H 'Authorization: AccessKey YOUR_ACCESS_KEY'
Codebeispiel
curl "/workspaces/{workspaceId}/transcriptions/{channelId}" \
     -H 'Authorization: AccessKey YOUR_SECRET_TOKEN'
To get the transcription content you use the endpoint for your preferred format:
  • GET /workspaces/{workspaceId}/transcriptions/{transcriptionId}.json
  • GET /workspaces/{workspaceId}/transcriptions/{transcriptionId}.srt
  • GET /workspaces/{workspaceId}/transcriptions/{transcriptionId}.vtt
  • GET /workspaces/{workspaceId}/transcriptions/{transcriptionId}.txt