# DeepL Documentation

## Docs

- [Admin API](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/admin-api.md): Explore DeepL API offering designed for admins
- [Get usage analytics](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/admin-api/get-usage-analytics.md): Retrieve usage statistics for the organization within a specified date range. Optionally group the results by API key or by API key and day.
- [Managing admin API keys](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/admin-api/managing-admin-keys.md): Learn how admins can create and manage admin API keys.
- [Managing developer API keys](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/admin-api/managing-developer-keys.md): Learn how admins can create and manage developer API keys.
- [Create a developer key](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/admin-api/managing-developer-keys/create-key.md)
- [Deactivate a developer key](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/admin-api/managing-developer-keys/deactivate-key.md)
- [Get developer keys](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/admin-api/managing-developer-keys/get-keys.md)
- [Rename a developer key](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/admin-api/managing-developer-keys/rename-key.md)
- [Set developer key limits](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/admin-api/managing-developer-keys/set-usage-limits.md)
- [Accessing organization usage analytics](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/admin-api/organization-usage-analytics.md): Learn how admins can retrieve and analyze usage data across their organization.
- [Detect Language](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/detect-language/detect-language-beta.md): Detect the language of text using DeepL's language detection service
- [Translate documents](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/document.md)
- [Check document status](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/document/check-document-status.md)
- [Download translated document](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/document/download-translated-document.md)
- [Upload and translate a document](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/document/upload-and-translate-a-document.md)
- [Monolingual glossaries (v2 endpoints)](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/glossaries.md): Manage glossaries using the v2 endpoints
- [Create a glossary](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/glossaries/create-a-glossary.md)
- [Delete a glossary](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/glossaries/delete-a-glossary.md): Deletes the specified glossary.
- [List all glossaries](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/glossaries/list-all-glossaries.md): List all glossaries and their meta-information, but not the glossary entries.
- [Retrieve glossary details](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/glossaries/retrieve-glossary-details.md): Retrieve meta information for a single glossary, omitting the glossary entries.
- [Retrieve glossary entries](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/glossaries/retrieve-glossary-entries.md): List the entries of a single glossary in the format specified by the `Accept` header.
- [v2 vs v3 endpoints](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/glossaries/v2-vs-v3-endpoints.md)
- [Improve text](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/improve-text.md)
- [Request text improvement](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/improve-text/request-text-improvement.md)
- [Retrieve languages](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/languages.md): API reference for retrieving supported languages with the DeepL API.
- [Common use cases](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/languages/language-feature-use-cases.md): Pseudocode examples for common language and feature lookup patterns using the v3/languages endpoints.
- [Migrating from v2/languages](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/languages/migrate-from-v2-languages.md): How to migrate from the v2/languages endpoint to the v3/languages endpoints.
- [Retrieve languages](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/languages/retrieve-languages-by-product.md): Returns languages supported by the specified DeepL API product. Each language indicates whether it can be used as a source language, a target language, or both, along with the features it supports for that product.
- [Retrieve language products](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/languages/retrieve-products.md): Returns all DeepL API products and the features they support.
- [Retrieve supported languages](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/languages/retrieve-supported-languages.md)
- [Retrieve supported languages by product](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/languages/retrieve-supported-languages-by-product.md): API reference for retrieving supported languages with the DeepL API across all products.
- [v3/languages changelog](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/languages/v3-languages-changelog.md): Changes and planned updates to the v3/languages endpoints during the beta period.
- [Glossaries](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/multilingual-glossaries.md): Manage and use DeepL glossaries
- [Create a glossary](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/multilingual-glossaries/create-a-glossary.md)
- [Delete a glossary](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/multilingual-glossaries/delete-a-glossary.md): Deletes the specified glossary.
- [Deletes the dictionary associated with the given language pair with the given glossary ID.](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/multilingual-glossaries/deletes-the-dictionary-associated-with-the-given-language-pair-with-the-given-glossary-id.md)
- [Edit glossary details](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/multilingual-glossaries/edit-glossary-details.md): Edit glossary details, such as name or a dictionary for a source and target language.
- [List all glossaries](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/multilingual-glossaries/list-all-glossaries.md): List all glossaries and their meta-information, but not the glossary entries.
- [List language pairs supported for glossaries](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/multilingual-glossaries/list-language-pairs-supported-by-glossaries.md): Retrieve the list of language pairs supported by the glossary feature.
- [Replaces or creates a dictionary in the glossary with the specified entries.](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/multilingual-glossaries/replaces-or-creates-a-dictionary-in-the-glossary-with-the-specified-entries.md)
- [Retrieve glossary details](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/multilingual-glossaries/retrieve-glossary-details.md): Retrieve meta information for a single glossary, omitting the glossary entries.
- [Retrieve glossary entries](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/multilingual-glossaries/retrieve-glossary-entries.md): List the entries of a single glossary in tsv format.
- [Style rules](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/style-rules.md): Manage a shared list of rules for style, formatting, and more
- [Create a custom instruction](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/style-rules/create-custom-instruction.md)
- [Create a style rule list](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/style-rules/create-style-rule.md)
- [Delete a custom instruction](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/style-rules/delete-custom-instruction.md)
- [Delete a style rule list](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/style-rules/delete-style-rule.md)
- [Get a custom instruction](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/style-rules/get-custom-instruction.md)
- [Get a style rule list](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/style-rules/get-style-rule.md)
- [Get all style rule lists](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/style-rules/list-all-style-rules.md)
- [Replace configured rules](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/style-rules/update-configured-rules.md)
- [Replace a custom instruction](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/style-rules/update-custom-instruction.md)
- [Update a style rule list's name](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/style-rules/update-style-rule.md)
- [Translate Text](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/translate.md): API reference for translating text with the DeepL API.
- [Translate text](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/translate/request-translation.md)
- [List translation memories](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/translation-memory/list-translation-memories.md): Retrieve translation memories associated with your account, used to store and reuse previously created translations. See [How to use translation memories](/docs/learning-how-tos/examples-and-guides/how-to-use-translation-memories) to use them in translation requests.
- [Retrieve usage and quota](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/usage-and-quota.md): API reference for retrieving usage and quota for the current billing period with the DeepL API.
- [Check usage and limits](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/usage-and-quota/check-usage-and-limits.md)
- [Translate Speech in Realtime](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/voice.md): API reference for real-time voice transcription and translation with the DeepL Voice API.
- [Reconnect Session](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/voice/reconnect-session.md)
- [Request Session](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/voice/request-session.md)
- [WebSocket Streaming](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/voice/websocket-streaming.md): WebSocket channel for streaming audio and receiving transcriptions and translations. Messages are exchanged in JSON or MessagePack format. WebSocket messages are exchanged in TEXT frames when using JSON format and in BINARY frames when using MessagePack format. Sending the wrong frame type will resu…
- [CORS requests](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/best-practices/cors-requests.md)
- [Subscription-level cost control](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/best-practices/cost-control.md)
- [Custom instructions](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/best-practices/custom-instructions.md): Learn how to create effective custom instructions to customize your translation behavior
- [Document translations](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/best-practices/document-translations.md)
- [Error handling](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/best-practices/error-handling.md)
- [Language detection](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/best-practices/language-detection.md)
- [Pre-production checklist](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/best-practices/pre-production-checklist.md): Here's what we recommend reviewing to get your DeepL API application ready for production.
- [About](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/getting-started/about.md)
- [SDKs](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/getting-started/client-libraries.md): Using your favorite programming language with the DeepL API
- [DeepL CLI](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/getting-started/deepl-cli.md): Install and use the DeepL CLI to translate text, documents, and more from your terminal.
- [DeepL MCP Server](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/getting-started/deepl-mcp-server.md): Use the DeepL MCP Server to add translation capabilities to Claude, Cursor, and other AI agents.
- [Managing API keys](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/getting-started/managing-api-keys.md): A guide to creating API keys, getting API key-level usage, and setting API key-level limits.
- [Quickstart](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/getting-started/quickstart.md)
- [Regional API Endpoints](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/getting-started/regional-endpoints.md): Reference documentation for DeepL's regional API endpoints, including endpoint URLs, configuration, and technical specifications.
- [Languages supported](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/getting-started/supported-languages.md): The DeepL API supports the following languages.
- [Postman](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/getting-started/test-your-api-requests-with-postman.md): Use our official Postman collection to get familiar with and test the DeepL API.
- [Automating Indie Game Localization with the DeepL API and Godot](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/learning-how-tos/cookbook/automating-indie-game-localization-with-the-deepl-api-and-godot.md): Efficiently translate content for a global audience and widen your game's reach
- [Project: Google Sheets](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/learning-how-tos/cookbook/google-sheets.md): Open-source example showing how to build a Google Sheets App using the DeepL API.
- [Building a Document Translator with the DeepL API](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/learning-how-tos/cookbook/java-document-translator.md): Streamline document localization workflows with automated translation for businesses and developers
- [Making API calls from client-side JavaScript](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/learning-how-tos/cookbook/nodejs-proxy.md): Two lightweight local proxies that let you try the DeepL API directly from a website
- [Usage Analytics Dashboard](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/learning-how-tos/cookbook/usage-analytics-dashboard.md): A demo dashboard for visualizing DeepL API key usage across an entire account using the Admin API.
- [DeepL MCP Server: How to build and use translation in LLM applications](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/learning-how-tos/examples-and-guides/deepl-mcp-server-how-to-build-and-use-translation-in-llm-applications.md): Efficiently translate content with AI-powered translation and enhance your interactions with large language models.
- [Enable support for Beta languages](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/learning-how-tos/examples-and-guides/enable-beta-languages.md): Enable support for Beta languages.
- [Glossaries in the real world](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/learning-how-tos/examples-and-guides/glossaries-in-the-real-world.md): A quick guide to using DeepL glossaries in translations
- [How to Use the Context Parameter Effectively](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/learning-how-tos/examples-and-guides/how-to-use-context-parameter.md): Learn when and how to use the context parameter to improve translation accuracy for ambiguous content.
- [Translate text using a translation memory](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/learning-how-tos/examples-and-guides/how-to-use-translation-memories.md): Learn how to retrieve your translation memories and use them in translation requests
- [Mustache placeholder tags](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/learning-how-tos/examples-and-guides/placeholder-tags.md): An example for working with placeholder tags—in this case, Mustache tags.
- [How to Translate Between Language Variants](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/learning-how-tos/examples-and-guides/translating-between-variants.md): Learn how to translate between language variants, like British English and US English, using the DeepL API.
- [Translation: a beginner's guide](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/learning-how-tos/examples-and-guides/translation-beginners-guide.md): An introduction to sending translation requests with the DeepL API
- [Alpha and beta features](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/resources/alpha-and-beta-features.md): Learn more about alpha and beta features in the DeepL API and how to best make use of them.
- [Breaking changes (Change Notices)](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/resources/breaking-changes-change-notices.md)
- [July 2024: Deprecation of insecure cipher suites](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/resources/breaking-changes-change-notices/july-2024-deprecation-of-insecure-cipher-suites.md)
- [March 2025: Deprecating GET requests to /translate and authenticating with auth_key](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/resources/breaking-changes-change-notices/march-2025-deprecating-get-requests-to-translate-and-authenticating-with-auth_key.md)
- [November 2025: Deprecation of query parameter and request body authentication](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/resources/breaking-changes-change-notices/november-2025-deprecation-of-legacy-auth-methods.md)
- [Developer Community](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/resources/deepl-developer-community.md)
- [Language release process](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/resources/language-release-process.md): Here's what API users can expect when DeepL adds translation support for a new language or language variant.
- [Open API spec](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/resources/open-api-spec.md)
- [Changelog](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/resources/roadmap-and-release-notes.md): The latest features and improvements in the DeepL API, plus what's coming next
- [Usage and limits](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/resources/usage-limits.md)
- [Customized XML outline detection](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/xml-and-html-handling/customized-xml-outline-detection.md): Learn how to customize XML outline detection with the DeepL API.
- [HTML handling](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/xml-and-html-handling/html.md): Learn how to translate HTML content with the DeepL API.
- [Structured XML content](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/xml-and-html-handling/structured-content.md): Learn how to work with structured XML content with the DeepL API.
- [New: XML/HTML handling v2](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/xml-and-html-handling/tag-handling-v2.md): Learn about the benefits of tag handling v2 and how to migrate.
- [XML handling](https://deepl-c950b784-update-customizations-langs.mintlify.app/docs/xml-and-html-handling/xml.md): Learn how to translate XML content with the DeepL API.

## OpenAPI Specs

- [openapi](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/openapi.yaml)

## AsyncAPI Specs

- [voice.asyncapi](https://deepl-c950b784-update-customizations-langs.mintlify.app/api-reference/voice/voice.asyncapi.yaml)