GET/transcript/{jobId}

Get transcript job status and results

Retrieves the status and results of a transcript job. Use jobId to identify the job and check whether it is queued, active, completed, or failed. Completed results may include transcript content, its language, and available language codes.

1 parameter
jobIdstringrequired
The identifier of the transcript job to retrieve.

6 status codes
200Returns the job status and may include error information, transcript content, the transcript language, and available language codes.
statusstringrequired
Current status of the job
Allowed:queuedactivecompletedfailed
errorobjectoptional
Error information if the job failed
contentarray<object>optional
langstringoptional
ISO 639-1 language code of transcript
availableLangsarray<string>optional
List of available language codes
400Returned when the request is invalid.
errorstringrequired
Error code identifying the type of error
Allowed:invalid-requestinternal-errorforbiddenunauthorizedupgrade-requiredtranscript-unavailablenot-foundlimit-exceeded
messagestringrequired
Human readable error message
detailsstringrequired
Detailed error description
documentationUrlstringoptional
URL to error documentation
401Returned when the request is unauthorized.
errorstringrequired
Error code identifying the type of error
Allowed:invalid-requestinternal-errorforbiddenunauthorizedupgrade-requiredtranscript-unavailablenot-foundlimit-exceeded
messagestringrequired
Human readable error message
detailsstringrequired
Detailed error description
documentationUrlstringoptional
URL to error documentation
404Returned when the transcript job is not found.
errorstringrequired
Error code identifying the type of error
Allowed:invalid-requestinternal-errorforbiddenunauthorizedupgrade-requiredtranscript-unavailablenot-foundlimit-exceeded
messagestringrequired
Human readable error message
detailsstringrequired
Detailed error description
documentationUrlstringoptional
URL to error documentation
429Returned when the request limit is exceeded.
errorstringrequired
Error code identifying the type of error
Allowed:invalid-requestinternal-errorforbiddenunauthorizedupgrade-requiredtranscript-unavailablenot-foundlimit-exceeded
messagestringrequired
Human readable error message
detailsstringrequired
Detailed error description
documentationUrlstringoptional
URL to error documentation
500Returned when an internal error occurs.
errorstringrequired
Error code identifying the type of error
Allowed:invalid-requestinternal-errorforbiddenunauthorizedupgrade-requiredtranscript-unavailablenot-foundlimit-exceeded
messagestringrequired
Human readable error message
detailsstringrequired
Detailed error description
documentationUrlstringoptional
URL to error documentation

Error handling

A 400 indicates an invalid request, a 401 an unauthorized request, a 404 a missing resource, a 429 that the request limit was exceeded, and a 500 an internal error. The jobId path parameter must identify the transcript job whose status and results you need.