---
title: "Create Document Intelligence Job"
method: POST
path: "/doc-digitization/job/v1"
tags: ["documentIntelligence"]
---

# Create Document Intelligence Job

`POST /doc-digitization/job/v1`

Creates a new Document Intelligence job.

**Supported Languages (BCP-47 format):**
- `hi-IN`: Hindi (default)
- `en-IN`: English
- `bn-IN`: Bengali
- `gu-IN`: Gujarati
- `kn-IN`: Kannada
- `ml-IN`: Malayalam
- `mr-IN`: Marathi
- `od-IN`: Odia
- `pa-IN`: Punjabi
- `ta-IN`: Tamil
- `te-IN`: Telugu
- `ur-IN`: Urdu
- `as-IN`: Assamese
- `brx-IN`: Bodo
- `doi-IN`: Dogri
- `ks-IN`: Kashmiri
- `kok-IN`: Konkani
- `mai-IN`: Maithili
- `mni-IN`: Manipuri
- `ne-IN`: Nepali
- `sa-IN`: Sanskrit
- `sat-IN`: Santali
- `sd-IN`: Sindhi

**Output Formats (delivered as ZIP file):**
- `html`: Structured HTML files with layout preservation
- `md`: Markdown files (default)
- `json`: Structured JSON files for programmatic processing

## Headers

- `api-subscription-key` string, required

## Request body

- DocDigitizationCreateJobRequest — Request body for creating a new document intelligence job
  - `job_parameters` DocDigitizationJobParameters — Configuration parameters for Document Intelligence job. Specify the document language and desired output format.
    - `language` 'hi-IN' | 'en-IN' | 'bn-IN' | 'gu-IN' | 'kn-IN' | 'ml-IN' | 'mr-IN' | 'od-IN' | 'pa-IN' | 'ta-IN' | 'te-IN' | 'ur-IN' | 'as-IN' | 'brx-IN' | 'doi-IN' | 'ks-IN' | 'kok-IN' | 'mai-IN' | 'mni-IN' | 'ne-IN' | 'sa-IN' | 'sat-IN' | 'sd-IN' — BCP-47 language code specifying the primary language of the document. Supports 23 languages: 22 Indian languages (Hindi, Bengali, Tamil, Telugu, Marathi, Gujarati, Kannada, Malayalam, Odia, Punjabi, Assamese, Urdu, Sanskrit, Nepali, Konkani, Maithili, Sindhi, Kashmiri, Dogri, Manipuri, Bodo, Santali) and English language.
    - `output_format` 'html' | 'md' | 'json' — Output format for extracted document content, delivered as a ZIP file. 'html' returns structured HTML files, 'md' returns human-readable Markdown files, 'json' returns structured JSON files for programmatic processing.
  - `callback` DocDigitizationWebhookCallback — Webhook configuration for job completion notification
    - `url` string, uri, required — HTTPS webhook URL to call upon job completion (HTTP not allowed)
    - `auth_token` string — Authorization token sent as X-SARVAM-JOB-CALLBACK-TOKEN header

## Response `202`

Successful Response

- DocDigitizationCreateJobResponse
  - `job_id` string, uuid, required — Unique job identifier (UUID)
  - `storage_container_type` 'Azure' | 'Local' | 'Google' | 'Azure_V1', required
  - `job_parameters` DocDigitizationJobParameters, required — Configuration parameters for Document Intelligence job. Specify the document language and desired output format.
    - `language` 'hi-IN' | 'en-IN' | 'bn-IN' | 'gu-IN' | 'kn-IN' | 'ml-IN' | 'mr-IN' | 'od-IN' | 'pa-IN' | 'ta-IN' | 'te-IN' | 'ur-IN' | 'as-IN' | 'brx-IN' | 'doi-IN' | 'ks-IN' | 'kok-IN' | 'mai-IN' | 'mni-IN' | 'ne-IN' | 'sa-IN' | 'sat-IN' | 'sd-IN' — BCP-47 language code specifying the primary language of the document. Supports 23 languages: 22 Indian languages (Hindi, Bengali, Tamil, Telugu, Marathi, Gujarati, Kannada, Malayalam, Odia, Punjabi, Assamese, Urdu, Sanskrit, Nepali, Konkani, Maithili, Sindhi, Kashmiri, Dogri, Manipuri, Bodo, Santali) and English language.
    - `output_format` 'html' | 'md' | 'json' — Output format for extracted document content, delivered as a ZIP file. 'html' returns structured HTML files, 'md' returns human-readable Markdown files, 'json' returns structured JSON files for programmatic processing.
  - `job_state` 'Accepted' | 'Pending' | 'Running' | 'Completed' | 'PartiallyCompleted' | 'Failed', required — Current state of the document intelligence job

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `429` — Quota Exceeded / Rate Limited
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.dev/sarvam/apis/endpoints.md) · [All operations](https://skmtc.dev/sarvam/apis/endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sarvam/endpoints/revisions/2b7f7955b147/schema)