Live Status | Sarvam API Docs

from sarvamai import SarvamAI
import time
client = SarvamAI(api_subscription_key="YOUR_SARVAM_API_KEY")
TERMINAL = {"Completed", "PartiallyCompleted", "Failed"}
job_id = "550e8400-e29b-41d4-a716-446655440000"
while True:
    status = client.document_translation.get_live_status(job_id=job_id)
    print(f"job_state={status.job_state} progress={status.progress}%")
    if status.job_state in TERMINAL:
        break
    time.sleep(12)

{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "job_name": "chapter1",
  "job_state": "Running",
  "source_language_code": "en-IN",
  "created_at": "2026-08-04T10:00:00Z",
  "updated_at": "2026-08-04T10:05:00Z",
  "progress": 55,
  "page_metrics": {
    "total_pages": 42,
    "pages_processed": 23,
    "pages_succeeded": 23,
    "pages_failed": 0
  },
  "translations": [
    {
      "target_language_code": "hi-IN",
      "state": "Running",
      "pages_completed": 12,
      "pages_failed": 0
    },
    {
      "target_language_code": "ta-IN",
      "state": "Pending",
      "pages_completed": 0,
      "pages_failed": 0
    }
  ]
}

Poll the progress of a document translation job.

Authentication

api-subscription-keystring

API Key authentication via header

Path parameters

job_idstringRequired

The job_id returned by POST /translate/document/jobs.

Response

Live status.

job_idstring

job_namestring

job_stateenum

Aggregate job state returned by GET /jobs/{job_id}/live-status.

source_language_codestring

created_atstringformat: "date-time"

updated_atstringformat: "date-time"

progressintegerOptionalDefaults to 0

Overall progress (0-100).

page_metricsobject or nullOptional

Present for PDF (page-granular) jobs.

translation_metricsobject or nullOptional

Present for Office format (document-granular) jobs.

translationslist of objectsOptionalDefaults to []

warningslist of strings or nullOptional

Server warnings. Omitted when empty.

error_messagestring or nullOptional

Job-level failure reason.

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error