Skip to main content
GET
/
v1
/
jobs
/
voice
/
translate
/
{job_id}
Get voice translation job status
curl --request GET \
  --url https://api.deepl.com/v1/jobs/voice/translate/{job_id} \
  --header 'Authorization: <api-key>'
{ "job_id": "a74d88fb-ed2a-4943-a664-a4512398b994", "product": "voice", "operation": "translate", "created_at": "2026-10-01T01:03:03.444Z", "updated_at": "2026-10-01T04:03:03.333Z", "usage": { "storage_used": 31457280 }, "source_file": { "name": "podcast-episode-42.mp3", "content_type": "audio/mpeg", "content_length": 15728640 }, "parameters": { "source_language": "en" }, "targets": [ { "language": "de", "type": "text/plain" }, { "language": "es", "type": "audio/pcm;encoding=s16le;rate=16000" } ], "results": [ { "status": "processing" }, { "status": "processing" } ] }

Authorizations

​
Authorization
string
header
default:DeepL-Auth-Key
required

Authentication with Authorization header and DeepL-Auth-Key authentication scheme. Example: DeepL-Auth-Key <api-key>

Path Parameters

​
job_id
string<uuid>
required

The unique identifier of the job, returned by the create job endpoint.

Example:

"a74d88fb-ed2a-4943-a664-a4512398b994"

Query Parameters

​
include
enum<string>[]

Additional fields to include in the response.

  • signed_url: Include pre-signed URLs (signed_upload_url on create, signed_download_url on status) that can be used without an authorization header.
Available options:
signed_url

Response

Job status retrieved successfully.

​
job_id
string<uuid>
required

The unique identifier of the job.

​
product
string
required

The product identifier.

Example:

"voice"

​
operation
string
required

The operation identifier.

Example:

"translate"

​
created_at
string<date-time>
required

When the job was created (ISO 8601).

​
updated_at
string<date-time>
required

When the job was last updated (ISO 8601).

​
usage
object
required
​
source_file
object
required

Metadata about the uploaded source audio file.

​
parameters
object
required

Processing parameters as applied to the voice translation job.

​
targets
object[]
required

The translation targets as specified in the create request.

​
results
object[]
required

Per-target processing results, in the same order as the targets array.