HTTP response codes in the 4xx range indicate an error that resulted from the request data. HTTP response codes in the 5xx range indicate an error with our servers.

When an error occurs, the API will return an error object in JSON format.

Error Object Attributes

FieldDescription
typeThe type of error returned
messageA human-readable description of the error

Error Types

TypeMessage
server_errorA server error occurred
invalid_request_errorThe request has invalid parameters
authentication_errorThe API Key was not authorized
conflict_errorAn order already exists with this order id

Example error response object

HTTP/1.1 409 Conflict
{
  "type": "conflict_error",
  "message": "An order already exists with this order id"
}