Error Handling

All successful requests to the API return an HTTP 200 or 201. In case of errors, the API returns a JSON response containing the error code and details about the error:

{
  "errors": [
    {
      "error-description": "Price Group cannot be null or empty",
      "error": "Price group must contain an id"
    }
  ]
}

The format of the error description varies between error codes.

The following combinations of error codes are returned from the API:

HTTP	Description	Handling
400	Invalid input provided. See details.	Check that the input sent is correct.
401	Incorrect Client ID and/or Client Secret in HTTP header or Access Token invalid.
403	The authentication token does not have access to this endpoint.
404	A resource with the supplied ID was not found in the current store.	Try with an existing resource.
500	Unknown error.	Not retryable.
504	Gateway time out.	Call can be retried.