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

Field

Description

type

The type of error returned

message

A human-readable description of the error

Error Types

Type

Message

server_error

A server error occurred

invalid_request_error

The request has invalid parameters

authentication_error

The API Key was not authorized

conflict_error

An 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" }