HTTP Response Codes

Success

The server successfully carried out whatever action the client requested.
HTTP CODEHTTP MSGMETHOD TYPEDESCRIPTION
200OKGET
DELETE
PUT
POST
The server successfully carried out whatever action the client requested, and that no more specific code in the 2xx series is appropriate.
201CreatedPOST
PUT
The server sends this status code when it creates a new resource at the client’s request.
204No ContentGETThe resource exists, but based on the request the result is empty. Example: filter a corporate directory by a name which does not exist in the directory. i.e. No results found
304Not ModifiedGETReturned in conjunction with a conditional HTTP request. E.g. If-None-Match={Etag value) – If ETag matches then the 304 is returned without an entity-body

Client Error

There is a problem which the client needs to fix (e.g. validation error, invalid resource). A Confirm Message or Response Object is returned in the entity-body with details of the error.
HTTP CODEHTTP MSGMETHOD TYPEDESCRIPTION
400Bad RequestPOST
PUT
Generic client-side error status. It’s commonly used when the client submits a representation along with a PUT or POST request, and the representation is in the right format, but it doesn’t make sense.
403ForbiddenGET
POST
PUT
DELETE
The client’s request is formed correctly, but the server doesn’t want to carry it out. This is a resource which is unavailable at the time of the request.
404Not FoundGET
POST
PUT
DELETE
Server cannot find the resource.
415Unsupported
Media Type
POST
PUT
The server sends this status code if the client sends an unsupported representation. (E.g. accepted media-type is application/json)

Service Unavailable

Service is unavailable. Please try again later. A Confirm Message or Response Object is returned in the entity-body with details of the error.
HTTP CODEHTTP MSGMETHOD TYPEDESCRIPTION
500Internal
Server Error
GET
POST
PUT
DELETE
We have encountered a problem on our side when completing your request. We are working hard to get the service back up. Please try again later.