API Error Codes
Last updated
Last updated
400
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.
403
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.
Please also 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. The authentication key for CAT tools is included in the DeepL Pro Advanced and DeepL Pro Ultimate subscription plans.
404
The requested resource could not be found
This error occurs when the URL is wrong. Please check the path of the URL.
413
The request size exceeds the limit
This error occurs when the request size reaches the supported limit.
414
Request-URI 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.
429
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, please wait 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.
456
Quota exceeded. The character limit has been reached
This error occurs when you reach your character limit. Please check the cost control settings in your DeepL account and increase the limit if necessary.
5**
Internal error
Any error starting with 5 is an internal error. If you get error 503, please wait and try again later. If you get any other error, please contact DeepL Support.