Get a job, optionally waiting for a change

curl --request GET \
  --url https://api.rask.ai/v3/jobs/{job_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.rask.ai/v3/jobs/{job_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.rask.ai/v3/jobs/{job_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.rask.ai/v3/jobs/{job_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.rask.ai/v3/jobs/{job_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "job",
  "id": "91c3e7b2-4f8a-4d6e-9b1c-7a3e5f2d8c60",
  "workspace_id": "b2e0c6d4-5b1a-4f7e-9a3c-2d8f1e6a7b90",
  "type": "dub",
  "status": "running",
  "progress": 80,
  "stage": "merging",
  "queue_position": null,
  "estimated_finish_at": "2026-11-03T09:25:02Z",
  "overdue": false,
  "project_id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
  "media_id": null,
  "parent_job_id": null,
  "channel": "api",
  "params": {
    "type": "dub",
    "mode_requested": "auto",
    "mode_applied": "changed_segments",
    "expected_cost_minutes": 1
  },
  "details": null,
  "stages": null,
  "cost": {
    "credit_type": "minutes",
    "minutes": 1,
    "charged": true,
    "refunded": false,
    "refunded_at": null
  },
  "result": null,
  "error": null,
  "created_at": "2026-11-03T09:12:44Z",
  "started_at": "2026-11-03T09:20:02Z",
  "finished_at": null,
  "links": {
    "self": "/v3/jobs/91c3e7b2-4f8a-4d6e-9b1c-7a3e5f2d8c60",
    "project": "/v3/projects/6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
    "outputs": null,
    "media": null
  }
}

GET

jobs

{job_id}

Get a job, optionally waiting for a change

curl --request GET \
  --url https://api.rask.ai/v3/jobs/{job_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.rask.ai/v3/jobs/{job_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.rask.ai/v3/jobs/{job_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.rask.ai/v3/jobs/{job_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.rask.ai/v3/jobs/{job_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "object": "job",
  "id": "91c3e7b2-4f8a-4d6e-9b1c-7a3e5f2d8c60",
  "workspace_id": "b2e0c6d4-5b1a-4f7e-9a3c-2d8f1e6a7b90",
  "type": "dub",
  "status": "running",
  "progress": 80,
  "stage": "merging",
  "queue_position": null,
  "estimated_finish_at": "2026-11-03T09:25:02Z",
  "overdue": false,
  "project_id": "6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
  "media_id": null,
  "parent_job_id": null,
  "channel": "api",
  "params": {
    "type": "dub",
    "mode_requested": "auto",
    "mode_applied": "changed_segments",
    "expected_cost_minutes": 1
  },
  "details": null,
  "stages": null,
  "cost": {
    "credit_type": "minutes",
    "minutes": 1,
    "charged": true,
    "refunded": false,
    "refunded_at": null
  },
  "result": null,
  "error": null,
  "created_at": "2026-11-03T09:12:44Z",
  "started_at": "2026-11-03T09:20:02Z",
  "finished_at": null,
  "links": {
    "self": "/v3/jobs/91c3e7b2-4f8a-4d6e-9b1c-7a3e5f2d8c60",
    "project": "/v3/projects/6f1c2b7e-8a4d-4e3f-9b5c-1d0a7e2f3c58",
    "outputs": null,
    "media": null
  }
}

With wait_seconds (<= 20) the request returns as soon as the job changes or is terminal, or after the wait; with If-None-Match set to the previous ETag it answers 304 when nothing changed; a terminal job ignores If-None-Match and always answers 200. Non-terminal responses carry Retry-After (the type’s poll hint). Status is monotonic. Finished jobs can be read for 90 days, then answer 404 job_not_found. When to use: to wait for any 202 job: loop wait_seconds=20 until succeeded, failed or canceled; never poll faster than Retry-After. When estimated_finish_at is minutes away, keep the job id and check back later. Then read result (links minted at read time) or error. Side effects: None. Cost: Free. About 10 concurrent waits per key and 50 per payer (429 too_many_waiters, policy long-poll). Idempotency: safe and pure (never writes); retry freely. Required scopes: jobs:read Errors: too_many_waiters (429)

Authorizations

Authorization

string

header

required

API key from Settings -> API keys, sent as Authorization: Bearer <key> (SDK environment variable RASK_API_KEY). Bound to one workspace and one acting user. Operations list the scopes they need (OpenAPI 3.1 scopes on a bearer scheme).

Scopes

jobs:read

Headers

If-None-Match

string

The job's previous ETag (opaque; it changes when the job's status, stage, progress, result or error changes, and when the job passes estimated_finish_at or turns overdue; queue_position, a localization job's stages and an on-screen job's details can change without it): with wait_seconds the request returns when the job differs from it, else 304. A terminal job ignores it and always answers 200.

Maximum string length: 128

Path Parameters

job_id

string

required

Job id (from a 202 response's Location).

Maximum string length: 64

Query Parameters

wait_seconds

integer<int32>

default:0

Hold the request up to this many seconds until the job changes or is terminal (0 = return at once).

Required range: 0 <= x <= 20

Response

OK: Job.

Asynchronous work started through v3, and automatic follow-up work (auto-dub, on-screen auto-start, the stages of a localization run) on projects created through v3. Started by 202 responses (Location: /v3/jobs/{id}); wait with getJob wait_seconds. Finished jobs can be read for 90 days, then answer 404 job_not_found. Work started in the web app or API v2 has no job.

object

enum<string>

required

Always job.

Available options:

job

string

required

Job id.

workspace_id

string

required

Workspace that owns the job (and whose owner pays).

type

enum<string>

required

Job type. Open enum: new types are added over time.

media_import: registering uploaded or imported media (poll hint 3 s; cancelable)
project_processing: the project pipeline up to translation (poll hint 10 s)
translation: retranslating segments (poll hint 5 s)
segment_generation: paid voicing of chosen segments into downloadable clips (poll hint 5 s)
dub: dubbing or redubbing (poll hint 10 s)
lipsync: lip-sync (poll hint 30 s)
onscreen: on-screen text translation (poll hint 15 s; cancelable while queued)
localization: dub, lip-sync and on-screen as one run with child jobs (poll hint 15 s)
voice_clone: creating a voice clone (poll hint 10 s)
export: rendering an export (poll hint 15 s)
file_restore: restoring archived files (poll hint 300 s)

Available options:

media_import,

project_processing,

translation,

segment_generation,

dub,

lipsync,

onscreen,

localization,

voice_clone,

export,

file_restore

status

enum<string>

required

Job status. Monotonic: never goes backwards and never leaves a terminal state.

queued: accepted, not started
running: in progress
succeeded: finished; see result
failed: finished; see error
canceled: canceled, or its project was deleted (error.code = project_deleted)

Available options:

queued,

running,

succeeded,

failed,

canceled

progress

integer<int32> | null

required

0-100; null when the type has no honest progress.

Required range: 0 <= x <= 100

stage

enum<string> | null

required

Per-type stage; for a localization job, the running stage's.

Available options:

queued,

uploading,

transcribing,

separating_audio,

detecting_speakers,

matching_voices,

translating,

voicing,

merging,

downloading,

extracting_audio,

face_check,

waiting_for_worker,

rendering,

charging,

waiting_for_runner,

starting,

preparing,

checking,

publishing,

cloning,

restoring

queue_position

integer<int32> | null

required

Queue position (1 = next).

estimated_finish_at

string<date-time> | null

required

Estimated completion from the queue position and the type's typical duration (on-screen: the runner's ETA); null when terminal or unknown. An estimate, not a deadline.

overdue

boolean

required

True once the job runs past its type's overdue threshold: Rask is alerted. Keep waiting or check back later; do not start the same work again.

project_id

string | null

required

Project.

media_id

string | null

required

Media.

parent_job_id

string | null

required

The job that started this system job: the project_processing job of an auto-dub, the dub whose merge started an on-screen auto-start, the localization job of a stage, the project_processing job of a localization block, or the failed run a resumed localization job continues.

channel

enum<string>

required

Who started a job.

api: REST API v3
mcp: the Rask MCP server
system: automatic (auto-dub, on-screen auto-start, the stages of a localization run)

Available options:

api,

mcp,

system

params

object

required

Normalized request echo: a union on type (= Job.type).

Show child attributes

details

object | null

required

Live per-type state.

Show child attributes

stages

object[] | null

required

The stages of a localization job in run order; null for other types.

Show child attributes

cost

object

required

Quoted at creation; charged turns true once the charge is committed. A localization job has no charge of its own: minutes is the sum of its stages charged and not refunded so far, charged is true once any stage is charged, refunded is true only when every charged stage was refunded, refunded_at is the latest refund. stages[].cost holds each stage; the quote is params.expected_cost_minutes.

Option 1
Option 2

Show child attributes

result

object

required

Set when succeeded; a failed segment_generation job may also list clips already voiced.

Show child attributes

error

object | null

required

Set when failed; on a canceled job only for the cancellation reason project_deleted (the project was deleted while the job ran; its work is discarded, refunded only for on-screen); instance is /v3/jobs/{id}, detail is generic. Each code's status, retry, recommendation and hint are in components.x-rask-job-errors. Codes by type: media_import source_download_failed, unsupported_media_type, media_corrupt, media_processing_failed, media_too_large (a voice sample above its limit); project_processing media_processing_failed, source_unavailable, no_audio_track, transcription_failed, no_speech_detected, audio_separation_failed, speaker_detection_failed, translation_failed, subtitle_import_rolled_back, project_processing_timeout, internal_error; translation translation_failed, translation_dispatch_failed, translation_timeout; segment_generation (cause_code) segment_generation_failed, segment_generation_timeout; localization localization_stage_failed, localization_stage_skipped (failed_stage, cause_code); dub (cause_code) dub_voiceover_failed, dub_merge_failed, dub_failed, dub_timeout; lipsync lipsync_failed, face_check_failed, no_face_detected, lipsync_rejected (cause_code), lipsync_timeout; onscreen onscreen_queue_timeout, onscreen_runner_lost, onscreen_runner_failed, onscreen_provider_unavailable, onscreen_finalize_timeout, onscreen_invalid_result, onscreen_publish_failed, onscreen_source_unavailable, onscreen_charge_failed; voice_clone voice_clone_failed, voice_clone_timeout; export export_failed; file_restore restore_failed. A failed job refunds its minutes (onscreen_charge_failed never charged). A failed localization job refunds only the failed stage, by its type's rule: succeeded stages stay charged, and skipped or unreached stages were never charged. A failed project_processing job refunds its project credit when a stage from transcription to translation failed, when it timed out and when a copy failed, but not for media_processing_failed, source_unavailable, no_audio_track or the internal_error of a new project.

Show child attributes

created_at

string<date-time>

required

Creation time.

started_at

string<date-time> | null

required

Start time.

finished_at

string<date-time> | null

required

End time.

links

object

required

Path-absolute API links.

Show child attributes

Get started

AI agents

Recipes

Concepts

Errors

Account

Usage

Catalogs

Uploads

Media

Projects

Exports

Glossaries

Jobs

Transcript

Segments

Versions

Speakers

Voices

Voice clones

Dubbing

Lipsync

Onscreen

Get a job, optionally waiting for a change

Authorizations

Scopes

Headers

Path Parameters

Query Parameters

Response