# DeepL API Error Codes

{% embed url="<https://support.deepl.com/hc/en-us/articles/9773964275868-DeepL-API-error-messages>" %}

<table><thead><tr><th width="130.06669108072919" valign="top">Error Codes</th><th width="275.199951171875" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top"><strong>400</strong></td><td valign="top">Bad request. Please check error message and your parameters</td><td valign="top">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.</td></tr><tr><td valign="top"><strong>403</strong></td><td valign="top">Authorization failed. Please supply a valid auth_key parameter</td><td valign="top"><p>This error occurs when the API key in the request is either missing or incorrect.</p><p>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 <a href="https://www.deepl.com/en/your-account">DeepL account</a>, under <em>API keys</em>.</p><p>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 <a href="https://www.deepl.com/en/pro#developer">DeepL API plan</a>.</p></td></tr><tr><td valign="top"><strong>404</strong></td><td valign="top">The requested resource could not be found</td><td valign="top">This error occurs when the URL is wrong. Check the path of the URL.</td></tr><tr><td valign="top"><strong>413</strong></td><td valign="top">The request size exceeds the limit</td><td valign="top">This error occurs when the request size reaches the supported limit.</td></tr><tr><td valign="top"><strong>414</strong></td><td valign="top">Request-URI Too Long</td><td valign="top">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.</td></tr><tr><td valign="top"><strong>429</strong></td><td valign="top">Too many requests. Please wait and resend your request</td><td valign="top"><p>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.</p><p>Sending less text in a single request may reduce the likelihood of this error.</p></td></tr><tr><td valign="top"><strong>456</strong></td><td valign="top">Quota exceeded. The character limit has been reached</td><td valign="top">This error occurs when you reach your character limit. Check the cost control settings in your <a href="https://www.deepl.com/en/your-account">DeepL account</a> and increase the limit if necessary.</td></tr><tr><td valign="top"><strong>5**</strong></td><td valign="top">Internal error</td><td valign="top">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, <a href="https://support.deepl.com/hc/articles/4407398772882">contact DeepL Support</a>.</td></tr></tbody></table>
