HTTP Responses

HTTP status codes

The server returns the following HTTP error response codes when encountering problems:

• 400 - When receiving an invalid request URI, invalid HTTP header or invalid message body.
• 401 - When missing authorization credentials or not authorized to access the requested resource.
• 403 - The server understood the request but is refusing to fulfill it. Authorization will not help. The current authorization context does not allow the request.
• 404 - The server does not find the resource that matches the request URI.
• 405 - The method specified in the request is not allowed for the resource identified by the request.
• 500 - Internal error. This is the default code that is used for all unrecognized errors.
• 501 - The request was valid but has not been implemented by the provider.

Response body

The API returns data either as XML or JSON depending on the requests accept header. The header should be set to either application/xml or application/json.