# DeepL Translate Documents API

**Canonical:** https://apis.io/apis/deepl/deepl-translatedocuments-api/  
**Provider:** DeepL — https://apis.io/providers/deepl/  
**Base URL:** https://api.deepl.com/v3  
**Documentation:** https://developers.deepl.com/api-reference/voice

DeepL Translate Documents API is one of 15 APIs that [DeepL](https://apis.io/providers/deepl/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. Tagged areas include TranslateDocuments. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and 2 JSON Schemas.

The document translation API allows you to translate whole documents and supports the following file types and extensions: * `docx` - Microsoft Word Document * `pptx` - Microsoft PowerPoint Document * `xlsx` - Microsoft Excel Document * `xlsm` - Microsoft Excel Macro-Enabled Workbook (currently in beta) * `pdf` - Portable Document Format * `htm / html` - HTML Document * `txt` - Plain Text Document * `xlf / xliff` - XLIFF Document (versions 1.2, 2.0, and 2.1) * `srt` - SRT Document * `vtt` - WebVTT Subtitle Document (currently in beta) * `idml` - Adobe InDesign Markup Language * `xml` - XML Document * `json` - JSON Document * `yaml / yml` - YAML Document (currently in beta) * `properties` - Java Properties Document (currently in beta) * `strings` - iOS/macOS Strings Document (currently in beta) * `md / markdown` - Markdown Document (currently in beta) * `dita` - DITA topic (Darwin Information Typing Architecture) * `mif` - Adobe FrameMaker Interchange Format * `zip` - SCORM Package (e-learning content, currently in beta) * `odt` - OpenDocument Text Document (currently in beta) * `rtf` - Rich Text Format Document (currently in beta) * `resx` - .NET Resource Document (currently in beta) * `jpeg` / `jpg` / `png` - Image (currently in beta)

## Operations (3)

| Method | Path | Summary |
|---|---|---|
| POST | `/v2/document` | Upload and Translate a Document |
| POST | `/v2/document/{document_id}` | Check Document Status |
| POST | `/v2/document/{document_id}/result` | Download Translated Document |

## Machine-readable artifacts (6)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/deepl/refs/heads/main/openapi/deepl-translatedocuments-api-openapi.yml
- **Documentation** — https://developers.deepl.com/docs
- **Reference** — https://developers.deepl.com/docs/api-reference
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deepl/refs/heads/main/json-schema/deepl-translation.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/deepl/refs/heads/main/json-schema/deepl-glossary.json
- **Rules** — https://raw.githubusercontent.com/api-evangelist/deepl/refs/heads/main/rules/deepl-translation-api-rules.yml

## Other DeepL APIs (12)

- [DeepL Voice API](https://apis.io/apis/deepl/deepl-voice-api/)
- [DeepL Admin API](https://apis.io/apis/deepl/deepl-adminapi-api/)
- [DeepL Correct Text API](https://apis.io/apis/deepl/deepl-correcttext-api/)
- [DeepL Manage Glossaries API](https://apis.io/apis/deepl/deepl-manageglossaries-api/)
- [DeepL Manage Multilingual Glossaries API](https://apis.io/apis/deepl/deepl-managemultilingualglossaries-api/)
- [DeepL Manage Spoken Terms API](https://apis.io/apis/deepl/deepl-managespokenterms-api/)
- [DeepL Meta Information API](https://apis.io/apis/deepl/deepl-metainformation-api/)
- [DeepL Quality Evaluation API](https://apis.io/apis/deepl/deepl-qualityevaluation-api/)
- [DeepL Rephrase Text API](https://apis.io/apis/deepl/deepl-rephrasetext-api/)
- [DeepL Style Rules API](https://apis.io/apis/deepl/deepl-style-rules-api/)
- [DeepL Translate Text API](https://apis.io/apis/deepl/deepl-translatetext-api/)
- [DeepL Translation Memories API](https://apis.io/apis/deepl/deepl-translationmemories-api/)

## Tags

TranslateDocuments

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/deepl/deepl-translatedocuments-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/deepl/.