HTTP Codes

The following table lists HTTP status codes that convey the results of a Web Services RESTful APIs request.

Table 1. HTTP return codes
HTTP code Description
HTTP/1.1 200 OK "OK" success code for requests other than creations and deletions
HTTP/1.1 201 OK "Created" success code for a POST request
HTTP/1.1 500 Internal Server Error The request failed due to internal error (Internal Server Error)
HTTP/1.1 404 Not Found The requested resource couldn't be found.
HTTP/1.1 401 Unauthorized (Unauthorized) The session ID or access token used has expired or is invalid. The response body contains the message and errorCode. The user must be logged in to make this API request. Check the value of the Authorization HTTP request header
HTTP/1.1 503 Service Unavailable Service unavailable

A backend error has occurred.

HTTP/1.1 400 Bad Request The request couldn’t be understood, usually because the JSON body contains an error. The API request is invalid or improperly formed. Consequently, the API server could not understand the request.
HTTP/1.1 403 Forbidden The request has been refused. Verify that the logged-in user has appropriate permissions. If the request syntax is correct, but the server is not able to find the item it. The requested operation is forbidden and cannot be completed