Error Handling

RESTful API responds to each request with a response status code.

The following table describes the list of response status codes:
Table 1. Response status codes
HTTP status code HTTP message Description
200 OK The request succeeded.
206 Partial Content The request succeeded, but the response contains only partial data of the resource.
400 Bad request The request contains invalid/missing parameters. Examples of invalid URL parameters are: non numeric values, redundant parameters, etc.
401 Unauthorized Not authenticated and lacks valid authentication credentials to access the resource.
403 Forbidden Authenticated but needs permission to access the resource. Insufficient rights to a resource.
404 Not found Indicates that the server cannot find the requested resource.
500 Server error The request is valid, but some application level error occurred.
503 Service Unavailable The service is temporarily unavailable.