The Magic API uses the conventional HTTP status codes to indicate success or failure of an API request.

HTTP Status CodeDescription
200-299The request was processed successfully
400-499The request was not valid (e.g. a required parameter was missing).
500-599The request could not be processed for an unexpected reason.


Returns a JSON object and an appropriate HTTP status code.

Please note that the human-readable textual messages included within the error object are improved over time. For validation and mapping purposes, please use the error code or HTTP status code values.

codestringThe type of error returned. E.g.:, order_refund_amount_invalid
httpStatusCodeintegerThe HTTP status code
messagestringA human-readable message which provides more details about the error. In most cases, these messages can be displayed to the end user.
titlestringA shorter resume of the error
    "errors": [
            "code": "order_refund_amount_invalid",
            "httpStatusCode": 400,
            "message": "The requested refund amount exceeds the order amount",
            "title": "Refund amount exceeds the order amount"