Standard HTTP Status Codes

To indicate "SUCCESS/FAILURE" of API calls, the following standard HTTP status codes are used. For every "SUCCESS/FAILURE" response, the response header contains the HTTP code and the response body contains detailed information about the success response or the error.

 HTTP Status Codes Message Details
200 Success Success with response body. Most GET requests will receive this response. If no data, an empty response body will be sent.
201 Created Success with response body. Used with POST URIs where a resource is created in DB.
204 Success Success with no response body.
400 Bad Request The server cannot or will not process the request due to  a client error such as malformed request syntax, invalid request message framing, or deceptive request routing. To be used if URI syntax is not correct such as wrong format in q query.
401 Unauthorized User not authorized.
403 Forbidden Operation not permitted for the user.
404 Not found Request resource not found.
405 Method not allowed HTTP action not allowed for the requested API.
406 Not acceptable The endpoint does not support the response format specified in the request Accept header.
415 Unsupported media type The endpoint does not support the format of the request body.