DeepL API error messages

Bad request. Please check error message and your parameters

This error occurs when a required parameter of the request is missing or one of the specified parameters is not supported, is misspelled, or the value is wrong.

Authorization failed. Please supply a valid auth_key parameter

This error occurs when the API key in the request is either missing or incorrect.

For the API key to be valid, your subscription must be active. You can check your API key and the status of your subscription in your DeepL account, under API keys.

Check that you have the correct subscription plan for the usage you require. To get access to DeepL's API, you need to subscribe to the DeepL API plan. Visit our Plans & Pricing page to see which plans include the authentication key for CAT tools.

The requested resource could not be found

This error occurs when the URL is wrong. Check the path of the URL. 

The request size exceeds the limit

This error occurs when the request size reaches the supported limit. 

Consult the API documentation for detailed information about size limits, particularly for file translations.

If you are trying to translate a large text in a single translation request, consider splitting it up into multiple requests, e.g., split it by paragraph.

Request-URL Too Long

This error occurs if the API URLs are too long and is due to a length limit of the web server. You can avoid this error message by using a POST request instead of a GET request.

Too many requests. Please wait and resend your request

When you receive this response, wait some time and try again. If you get the same error again, try waiting longer between retries (e.g., double the wait time). Repeat this until the request succeeds. You can then gradually reduce the wait time again.

Sending less text in a single request may reduce the likelihood of this error.

Quota exceeded. The character limit has been reached

This error occurs when you reach your character limit. Check the cost control settings in your DeepL account and increase the limit if necessary.

Internal error

Any error starting with 5 is an internal error. If you get error 503, try waiting and try again later. If you get any other error, contact DeepL Support.