Here are the error message explained you can get on our API:
-
400 - Unexpected Token / Invalid Syntax: You will get this error if you send an invalid formatted JSON body. You can check and validate your JSON body here
-
401 - Unauthorized: You will get this error if you use no API key. Please check the specification of the API key in the header. The API key must be passed as "X-API-KEY" in the header.
-
403 - Forbidden: You will get this error if you use an incorrect API key. Please check the specification of the API key in the header. The API key must be passed as "X-API-KEY" in the header. Please also make sure that you are using the correct API Key for the correct environment. There are different keys for test and production environment.
-
404 - Not Found: If you get this error, you probably have the wrong URL. Please check the URL.
-
422 - Unprocessable Entity: You will get this error if you have an error in the request body. For this error, you will always receive a "message" in the response that explains the error in more detail. Here is an example:
If you send a request with an invalid country code, you will get the following error:
{
"statusCode": 422,
"message": [
"shipper.address.countryCode must be one of the following values: AL, AT, BE, BG, CH, CZ, DE, DK, EE, ES, FI, FR, GB, GR, HR, HU, IE, IT, LI, LT, LU, LV, NL, NO, SI, PL, PT, RS, RO, SE, SK, TR"
],
"error": "Unprocessable Entity"
}
-
500 - Internal Server Error: If you get this error, there is a bug in the body or in our system that is not further specified. Please contact us here and send us your request body or cURL.
-
502 - Bad Gateway: If you receive this error, we will probably have a problem with our system. By the time you receive this error, we will already be aware of it and working on a solution. You are still always welcome to contact us and ask.
In case of any error feel free to contact me (Lukas) via [email protected]. We reply very quickly.