Get Document Translation Status

GET

translate-doc

{task_id}

curl --request GET \
  --url https://client.camb.ai/apis/translate-doc/{task_id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client.camb.ai/apis/translate-doc/{task_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://client.camb.ai/apis/translate-doc/{task_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 => [
    "x-api-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

{
  "status": "SUCCESS",
  "run_id": 123
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Use this endpoint to monitor a document translation task created with Create Document Translation. Pass the task_id returned by the create request, and the API returns the current task status. When the status is SUCCESS, the response includes a run_id. Use that run_id with Get Document Translation Result to fetch the translated document download URL.

Status Values

PENDING: the document translation is still queued or processing.
SUCCESS: the document translation completed successfully, and a run_id is available.
ERROR: the task failed.
TIMEOUT: the task exceeded the processing timeout.
PAYMENT_REQUIRED: the workspace needs credits or an entitlement change before the task can complete.

Example

import time
import requests

API_KEY = "your-api-key"
BASE_URL = "https://client.camb.ai/apis"
TASK_ID = "your-task-id"

headers = {"x-api-key": API_KEY}

while True:
    response = requests.get(
        f"{BASE_URL}/translate-doc/{TASK_ID}",
        headers=headers,
    )
    response.raise_for_status()
    status = response.json()

    if status["status"] == "SUCCESS":
        run_id = status["run_id"]
        print(f"Document translation completed. Run ID: {run_id}")
        break

    if status["status"] in {"ERROR", "TIMEOUT", "PAYMENT_REQUIRED"}:
        raise RuntimeError(f"Document translation did not complete: {status}")

    time.sleep(2)

Poll at a reasonable interval, such as every few seconds, and stop when the task reaches a terminal status.

Authorizations

x-api-key

string

header

required

The x-api-key is a custom header required for authenticating requests to our API. Include this header in your request with the appropriate API key value to securely access our endpoints. You can find your API key(s) in the 'API' section of our studio website.

Path Parameters

task_id

string

required

The unique identifier returned when you submitted your document translation request. Use it to poll the task status.

Response

Successful Response

status

enum<string>

Available options:

SUCCESS,

PENDING,

TIMEOUT,

ERROR,

PAYMENT_REQUIRED

run_id

integer | null

Last modified on November 11, 2026

Get Document Translation Status

curl --request GET \
  --url https://client.camb.ai/apis/translate-doc/{task_id} \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://client.camb.ai/apis/translate-doc/{task_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://client.camb.ai/apis/translate-doc/{task_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 => [
    "x-api-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

{
  "status": "SUCCESS",
  "run_id": 123
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

Getting Started

Models

Tutorials

SDK Guides

Hosting Platforms

Integrations

API Reference

Other Products

Release Logs

Get Document Translation Status

Status Values

Example

Authorizations

Path Parameters

Response

​Status Values

​Example

Authorizations

Path Parameters

Response

Status Values

Example