Get voice translation job status

Returns the current status of a voice translation job, including per-target result statuses.

When a target’s status is complete, the response includes a download_url and signature for that target. Results are returned in the same order as the targets in the create request.

GET /v1/jobs/voice/translate/{job_id}

Get voice translation job status

cURL

curl --request GET \
  --url https://api.deepl.com/v1/jobs/voice/translate/{job_id} \
  --header 'Authorization: <api-key>'

200

processing

{
  "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

200

application/json

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

Show child attributes

source_file · object · required

Metadata about the uploaded source audio file.

Show child attributes

parameters · object · required

Processing parameters as applied to the voice translation job.

Show child attributes

targets · object[] · required

The translation targets as specified in the create request.

Show child attributes

results · object[] · required

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

Show child attributes