Request Errors

In the event of API request errors, AfterShip uses conventional HTTP response codes in the 4XX and 5XX range to indicate the reason behind the error along with the error code already defined in the response body.


In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error caused by the given information (E.g., you omitted a required parameter or a charge failed), and codes in the 5xx range indicate an error related to AfterShip’s servers.

HTTP Status Codemeta.codemeta.typeSample Error Message
200200OkThe request has been processed successfully.
400400BadRequestThe request body JSON payload is invalid.
401401UnauthorizedThe API key is invalid.
403403ForbiddenAccess forbidden.
429429TooManyRequestsRate limit exceeded. The default API call limit is 10 requests per second.
500500InternalErrorSomething went wrong on Automizely's end.
422422UnprocessableEntityInvalid request parameters.
42220001UnprocessableEntityUnable to parse the order information from the email content.
preparing...
preparing...
preparing...