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.
102 ProcessingThe server has received and is processing the request, but no response is available yet.
103 Early HintsProvides hints to the client about resources that can be preloaded while the server prepares the response.

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.
202 AcceptedThe request has been accepted for processing, but the processing has not been completed.
203 Non-Authoritative InformationThe response is from a transforming proxy and not the origin server.
204 No ContentThe server successfully processed the request and is not returning any content.
205 Reset ContentTells the client to reset the document view.
206 Partial ContentDelivers a partial response due to a range header sent by the client.

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.
303 See OtherThe response can be found under a different URI using a GET method.
304 Not ModifiedIndicates that the resource has not been modified since the version specified by If-Modified-Since or If-None-Match.
307 Temporary RedirectThe request should be repeated with another URI; method and body must not change.
308 Permanent RedirectThe request and all future requests should be repeated using another URI; method and body must not change.

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.
405 Method Not AllowedThe request method is known by the server but not supported by the target resource.
406 Not AcceptableThe requested resource can only generate content not acceptable according to the Accept headers.
408 Request TimeoutThe server timed out waiting for the request.
409 ConflictThe request could not be completed due to a conflict with the current state of the resource.
410 GoneThe resource requested is no longer available and will not be available again.
412 Precondition FailedOne or more conditions given in the request headers evaluated to false.
413 Payload Too LargeThe request entity is larger than limits defined by server.
415 Unsupported Media TypeThe media type of the request data is not supported by the server.
422 Unprocessable EntityThe request was well-formed but unable to be followed due to semantic errors.
429 Too Many RequestsThe user has sent too many requests in a given amount of time ('rate limiting').
431 Request Header Fields Too LargeThe server is unwilling to process the request because header fields are too large.

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.
505 HTTP Version Not SupportedThe server does not support the HTTP protocol version used in the request.
507 Insufficient StorageThe server is unable to store the representation needed to complete the request.
Knowledge is power.