---
title: "Get a 'translate-captions' job"
method: GET
path: "/robots/v0/jobs/translate-captions/{JOB_ID}"
tags: ["Translate Captions"]
---

# Get a 'translate-captions' job

`GET /robots/v0/jobs/translate-captions/{JOB_ID}`

Retrieves the current status and results of a 'translate-captions' job. Jobs are automatically deleted after 30 days.

## Path parameters

- `JOB_ID` string, required

## Response `200`

Current status for the requested job

- TranslateCaptionsJobResponse
  - `data` TranslateCaptionsJob, required
    - `id` string, required — Unique job identifier.
    - `passthrough` string — Arbitrary string supplied at creation, returned as-is.
    - `units_consumed` integer, required — Number of Mux AI units consumed by this job.
    - `created_at` integer, required — Unix timestamp (seconds) when the job was created.
    - `updated_at` integer, required — Unix timestamp (seconds) when the job was last updated.
    - `workflow` 'translate-captions', required
    - `parameters` TranslateCaptionsJobParameters, required
      - `asset_id` string, required — The Mux asset ID of the video whose captions will be translated.
      - `track_id` string, required — The Mux text track ID of the source caption track to translate. The asset must have a ready text track matching this ID or the request will be rejected.
      - `to_language_code` string, required — BCP 47 language code for the translated output (e.g. "es", "ja"). The asset must not already have a text track for this language.
      - `upload_to_mux` boolean — Whether to upload the translated VTT and attach it as a text track on the Mux asset. Defaults to true.
    - `status` 'pending' | 'processing' | 'completed' | 'errored' | 'cancelled', required — Current job status.
    - `outputs` TranslateCaptionsJobOutputs — Workflow results. Present when status is 'completed'.
      - `track_id` string — The Mux text track ID of the source caption track that was translated.
      - `uploaded_track_id` string — Mux text track ID of the uploaded translated captions. Present when upload_to_mux is true.
      - `temporary_vtt_url` string — Temporary pre-signed URL to download the translated VTT file. Present when upload_to_mux is true.
    - `errors` JobError[] — Error details. Present when status is 'errored'.
      - `type` string, required — Stable public error category identifier.
      - `message` string, required — Human-readable public error message.
      - `retryable` boolean — Whether retrying this job may resolve the error.
    - `resources` Resources — Related Mux resources linked to this job.
      - `assets` SlimlineAsset[], required — Mux assets associated with this job.
        - `id` string, required — Mux asset ID.
        - `meta` object — Mux asset metadata, if available.
          - `title` string — Asset title from Mux metadata.
          - `creator_id` string — Creator identifier from Mux metadata.
          - `external_id` string — External identifier from Mux metadata.
        - `passthrough` string — Passthrough string from the Mux asset.
        - `_links` object, required — Hypermedia links for the asset.
          - `self` object, required
            - `href` string, required — URL to the Mux asset resource.

## Other responses

- `403` — Robots is not enabled for this environment. Accept the Robots beta terms in the Mux Dashboard to enable access.
- `404` — No job exists for the supplied id
- `500` — Server error

---

[API](https://skmtc.net/muxinc/apis/mux-api.md) · [All operations](https://skmtc.net/muxinc/apis/mux-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/muxinc/mux-api/revisions/34a65dce0f31/schema)