VoiceTranslateJob

Get voice translation job status

Changed on

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}

Request

  • Base URL
    https://api.deepl.com
  • URL
    https://api.deepl.com/v1/jobs/voice/translate/{job_id}
  • Auth
    API key in header Authorization

Path parameters

job_idstring uuid required
Example:a74d88fb-ed2a-4943-a664-a4512398b994

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

Query parameters

includestring[]

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.

Response

Job status retrieved successfully.

job_idstring uuid required

The unique identifier of the job.

productstring required

The product identifier.

operationstring required

The operation identifier.

created_atstring date-time required

When the job was created (ISO 8601).

updated_atstring date-time required

When the job was last updated (ISO 8601).

Example response

{
  "product": "voice",
  "operation": "translate",
  "parameters": {
    "source_language": "EN"
  },
  "targets": [
    {
      "language": "DE"
    }
  ],
  "results": [
    {
      "error": {
        "code": "invalid_content_type"
      }
    }
  ]
}

Changes