Skip to main content
GET
Get voice translation job status

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.