Get Status | Sarvam API Docs

{
  "job_id": "string",
  "job_state": "Accepted",
  "created_at": "2024-01-15T09:30:00Z",
  "updated_at": "2024-01-15T09:30:00Z",
  "storage_container_type": "Azure",
  "total_files": 0,
  "successful_files_count": 0,
  "failed_files_count": 0,
  "error_message": "",
  "job_details": [
    {
      "inputs": [
        {
          "file_name": "string",
          "file_id": "string"
        }
      ],
      "outputs": [
        {
          "file_name": "string",
          "file_id": "string"
        }
      ],
      "state": "Pending",
      "total_pages": 0,
      "pages_processed": 0,
      "pages_succeeded": 0,
      "pages_failed": 0,
      "error_message": "",
      "error_code": "string",
      "page_errors": [
        {
          "page_number": 1,
          "error_code": "string",
          "error_message": "string"
        }
      ]
    }
  ]
}

Legacy API. The /doc-digitization/job/v1 endpoints remain available for existing integrations. For new integrations, use the Document Intelligence API under /doc-ai/v1.

Returns the current status of a job with page-level metrics.

Job States:

Accepted: Job created, awaiting file upload
Pending: File uploaded, waiting to start
Running: Processing in progress
Completed: All pages processed successfully
PartiallyCompleted: Some pages succeeded, some failed
Failed: All pages failed or job-level error

Page Metrics: Response includes detailed progress: total pages, pages processed, succeeded, failed, and per-page errors.

Authentication

api-subscription-keystring

API Key authentication via header

Path parameters

job_idstringRequiredformat: "uuid"

The unique identifier of the job

Response

Successful Response

job_idstringformat: "uuid"

Job identifier (UUID)

job_stateenum

Current job state

created_atstringformat: "date-time"

Job creation timestamp (ISO 8601)

updated_atstringformat: "date-time"

Last update timestamp (ISO 8601)

storage_container_typeenum

Storage backend type

Allowed values:

total_filesintegerOptionalDefaults to 0

Total input files (always 1)

successful_files_countintegerOptionalDefaults to 0

Files that completed successfully

failed_files_countintegerOptionalDefaults to 0

Files that failed

error_messagestringOptionalDefaults to

Job-level error message

job_detailslist of objectsOptional

Per-file processing details with page metrics

Errors

400

Bad Request Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error

503

Service Unavailable Error