HTTP Status Codes

A comprehensive reference for HTTP response status codes. These codes are issued by a server in response to a client's request using HTTP.

1xx: Informational

Request received, continuing process. These are temporary responses.

Key / CodeDescription
100 ContinueThe server has received the request headers and the client should proceed to send the request body.
101 Switching ProtocolsThe requester has asked the server to switch protocols and the server has agreed to do so.

2xx: Success

The action was successfully received, understood, and accepted.

Key / CodeDescription
200 OKStandard response for successful HTTP requests.
201 CreatedThe request has been fulfilled, resulting in the creation of a new resource.
204 No ContentThe server successfully processed the request and is not returning any content.

3xx: Redirection

Further action must be taken in order to complete the request.

Key / CodeDescription
301 Moved PermanentlyThis and all future requests should be directed to the given URI.
302 FoundCommonly used for temporary redirection. The URI of the requested resource has been changed temporarily.
304 Not ModifiedIndicates that the resource has not been modified since the version specified by the request headers If-Modified-Since or If-None-Match.

4xx: Client Error

The request contains bad syntax or cannot be fulfilled.

Key / CodeDescription
400 Bad RequestThe server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax).
401 UnauthorizedSimilar to 403 Forbidden, but specifically for use when authentication is required and has failed or has not yet been provided.
403 ForbiddenThe request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
404 Not FoundThe requested resource could not be found but may be available in the future.
429 Too Many RequestsThe user has sent too many requests in a given amount of time ('rate limiting').

5xx: Server Error

The server failed to fulfill an apparently valid request.

Key / CodeDescription
500 Internal Server ErrorA generic error message, given when an unexpected condition was encountered and no more specific message is suitable.
502 Bad GatewayThe server was acting as a gateway or proxy and received an invalid response from the upstream server.
503 Service UnavailableThe server is currently unavailable (because it is overloaded or down for maintenance).
504 Gateway TimeoutThe server was acting as a gateway or proxy and did not receive a timely response from the upstream server.
Knowledge is power.