Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The Document Translation REST API (version 2026-03-01) supports two translation models and a set of discovery operations. Synchronous translation processes a single document without Blob Storage and returns the translated file directly. Asynchronous batch translation processes one or more documents stored in Azure Blob Storage and lets you poll for status. Both models use neural machine translation (NMT) by default.
All requests require a custom domain endpoint. The format is https://{your-resource-name}.cognitiveservices.azure.com/.
Synchronous operations
| Operation | Method | Description | Reference |
|---|---|---|---|
| Translate a document | POST |
Translate a single document and receive the translated output in the response. No Blob Storage required. | Synchronous document translation |
Asynchronous batch operations
| Operation | Method | Description | Reference |
|---|---|---|---|
| Start batch translation | POST |
Submit one or more documents for asynchronous translation. Documents must be in Azure Blob Storage. Returns a job ID. | Start batch translation |
| Get translation status | GET |
Retrieve the overall status and document summary for a specific batch job. Poll until the job reaches a terminal state. | Get translation status |
| Get status for all translations | GET |
List all batch translation jobs submitted to your resource. Supports filtering and paging. | Get status for all translation jobs |
| Get status for all documents | GET |
Retrieve per-document status for all documents in a specific job. | Get status for all documents |
| Get status for a specific document | GET |
Retrieve status and output details for a single document within a job. | Get status for a specific document |
| Cancel translation | DELETE |
Cancel a job that is queued or in progress. | Cancel translation |
Discovery operations
| Operation | Method | Description | Reference |
|---|---|---|---|
| Get supported document formats | GET |
Retrieve a list of supported document formats and their MIME types. | Get supported document formats |
| Get supported glossary formats | GET |
Retrieve a list of supported glossary formats and their MIME types. | Get supported glossary formats |