HTTP Status and Error Codes

Every HTTP response contains an HTTP status code. Successful HTTP response code numbers range from 200 to 399. Standard HTTP error response code numbers range from 400 to 599.

The following list shows the successful and error code numbers that the REST API returns for each of the HTTP methods.

GET (single): 200, 400, 401, 404, 409
GET (collection): 200, 400, 401
PUT: 200, 400, 401, 404, 409
DELETE: 204, 400, 401, 409
POST: 201, 400, 401, 409

Note: For the PUT and DELETE operations, the API does not try to determine the validity of the ID initially. Instead, the API tries to run the update and delete queries directly. If an error occurs, the API returns the 409 Conflict code. If the API returns a 404 Not Found code in this situation, performance degrades.

In addition, the following error messages return under the following cases:

If the HTTP request contains an invalid or inaccessible URI address, the server responds with a 404 Not Found response code.
If the HTTP request contains an unsupported HTTP method for a valid URI, the server responds with a 405 Method Not Allowed response code.
If the HTTP request requests an unsupported media type (Accept header), the server responds with a 406 Not Acceptable response code.
If the HTTP request sends an unsupported media type (Content-Type header), the server responds with a 415 Unsupported Media Type response code.
Various syntax or internal Web Server errors can return a 500 internal error.