---
title: "Get voice translation job status"
method: GET
path: "/v1/jobs/voice/translate/{job_id}"
tags: ["VoiceTranslateJob"]
---

# Get voice translation job status

`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`

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.

## Path parameters

- `job_id` string, uuid, required

## Query parameters

- `include` string[]

## Response `200`

Job status retrieved successfully.

- VoiceTranslateJobStatusResponse
  - `job_id` string, uuid, required: The unique identifier of the job.
  - `product` string, required: The product identifier.
  - `operation` string, required: The operation identifier.
  - `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` JobUsage, required
    - `storage_used` integer: Total storage used by this job in bytes, including source and output files.
  - `source_file` JobSourceFileResponse, required: Metadata about the uploaded source audio file.
    - `name` string, required: The file name of the source audio file.
    - `content_type` string, required: The MIME type of the source audio file.
    - `content_length` integer, required: The size of the source audio file in bytes.
  - `parameters` VoiceTranslateJobParametersResponse, required: Processing parameters as applied to the voice translation job.
    - `source_language` string: Language of the source audio.
  - `targets` VoiceTranslateJobTargetResponse[], required: The translation targets as specified in the create request.
    - `language` string, required: The language into which the text should be translated. For the full list of supported target languages, see [supported languages](https://developers.deepl.com/docs/getting-started/supported-languages) or query the [`GET /v3/languages` endpoint](https://developers.deepl.com/docs/languages/using-the-languages-api).
    - `type` 'text/plain' | 'application/x-subrip' | 'audio/opus' | 'audio/flac' | 'audio/pcm;encoding=s16le;rate=16000' | 'audio/pcm;encoding=s16le;rate=24000' | 'audio/pcm;encoding=ulaw;rate=8000' | 'audio/pcm;encoding=alaw;rate=8000' | 'audio/x-matroska;codecs=aac' | 'audio/x-matroska;codecs=flac' | 'audio/x-matroska;codecs=opus' | 'audio/x-matroska;codecs=pcm_s16le;rate=16000' | 'audio/x-matroska;codecs=pcm_s16le;rate=24000' | 'video/mp2t;codecs=aac' | 'video/mp2t;codecs=opus' | 'audio/ogg;codecs=flac' | 'audio/ogg;codecs=opus' | 'audio/webm;codecs=opus', required: The desired output format for the translation target.
  - `results` VoiceTranslateJobTargetResult[], required: Per-target processing results, in the same order as the `targets` array.
    - `status` 'pending' | 'uploaded' | 'processing' | 'complete' | 'downloaded' | 'failed', required: The processing status of a target result. - `pending`: Job created, awaiting file upload. - `uploaded`: File uploaded, awaiting processing. - `processing`: Translation in progress. - `complete`: Translation complete, result available for download. - `downloaded`: Result has been downloaded. Assets are marked for deletion. - `failed`: Processing failed. See the `error` field for details.
    - `download_url` string, uri: The URL to download the translated result via `GET`. Requires the `Authorization: DeepL-Signature {signature}` header. Only present when `status` is `complete`. See [Download Result](/api-reference/jobs-voice-translate#download-result) for details.
    - `signature` string: A short-lived token used to authorize the result download. Only present when `status` is `complete`.
    - `signed_download_url` string, uri: A pre-signed download URL that does not require an authorization header. Only present when `status` is `complete` and `?include=signed_url` is specified.
    - `error` ErrorResponse
      - `message` string, required: A human-readable description of the error.
      - `code` string: A machine-readable identifier for the error, when available. Clients should match on this value rather than on `message` when branching on error types.

## Other responses

- `401`: Authorization failed. Please supply a valid `DeepL-Auth-Key` via the `Authorization` header.
- `404`: The requested resource could not be found.
- `429`: Too many requests. Please wait and resend your request.

## Changes

- **2026-11-03** `c7c91cfac5c0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/deepl/apis/deepl-api-documentation/changes/v1/jobs/voice/translate/:job_id/get.md)

---

[API](https://skmtc.dev/deepl/apis/deepl-api-documentation.md) - [All operations](https://skmtc.dev/deepl/apis/deepl-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/deepl/apis/deepl-api-documentation/revisions/c7c91cfac5c0?raw)