HTTP Status Codes A simple searchable guide

  • 1xx Informational 👋

    An informational response indicates that the request was received and understood.

    • 100

      Continue

      The initial part of a request has been received and has not yet been rejected by the server.

    • 101

      Switching Protocols

      The server understands and is willing to comply with the client's request, via the Upgrade header field, for a change in the application protocol being used on this connection.

    • 102

      Processing (WebDAV)

      An interim response used to inform the client that the server has accepted the full request, but has not yet completed it.

    • 103

      Early Hints

      This status code is primarily intended to be used with the Link header, letting the user agent start preloading resources while the server prepares a response.

  • 2xx Successful 👍

    The client's request was successfully received, understood, and accepted.

    • 200

      OK

      The request was successful.

    • 201

      Created

      The request was successful and has resulted in one or more new resources being created.

    • 202

      Accepted

      The request has been accepted for processing, but the processing has not been completed.

    • 203

      Non-Authoritative Information

      The request was successful but the enclosed payload has been modified from that of the origin server's 200 (OK) response by a transforming proxy.

    • 204

      No Content

      The server has successfully fulfilled the request and that there is no additional content to send in the response payload body.

    • 205

      Reset Content

      The server has fulfilled the request and desires that the user agent resets the "document view", which caused the request to be sent, to its original state as received from the origin server.

    • 206

      Partial Content

      The server is successfully fulfilling a range request for the target resource by transferring one or more parts of the selected representation, that correspond to the satisfiable ranges found in the requests's Range header field.

    • 207

      Multi-Status

      Provides status for multiple independent operations.

    • 226

      IM Used

      The server has fulfilled a GET request for the resource, and the response is a representation of the result of one or more instance-manipulations applied to the current instance.

  • 3xx Redirection 👉

    Indicates that further action needs to be taken by the user agent in order to fulfill the request.

    • 300

      Multiple Choices

      The target resource has more than one representation, each with its own more specific identifier, and information about the alternatives is being provided so that the user (or user agent) can select a preferred representation by redirecting its request to one or more of those identifiers.

    • 301

      Moved Permanently

      The target resource has been assigned a new permanent URI and any future references to this resource ought to use one of the enclosed URIs.

    • 302

      Found

      The target resource resides temporarily under a different URI.

    • 303

      See Other

      The server is redirecting the user agent to a different resource, as indicated by a URI in the Location header field, that is intended to provide an indirect response to the original request.

    • 304

      Not Modified

      A conditional GET request has been received and would have resulted in a 200 (OK) response if it were not for the fact that the condition has evaluated to false.

    • 305

      Use Proxy

      *Deprecated*

    • 307

      Temporary Redirect

      The target resource resides temporarily under a different URI and the user agent MUST NOT change the request method if it performs an automatic redirection to that URI.

    • 308

      Permanent Redirect

      The target resource has been assigned a new permanent URI and any future references to this resource outght to use one of the enclosed URIs. This status code is similar to 301 Moved Permanently, except that it does not allow rewriting the request method from POST to GET.

  • 4xx Client Error ✋

    The client seems to have erred. It most likely means that the client is sending a faulty request in some way.

    • 400

      Bad Request

      The server cannot or will not process the request because the received syntax is invalid, nonsensical, or exceeds some limitation on what the server is willing to process.

    • 401

      Unauthorized

      The client must authenticate itself with valid credentials to get the requested response.

    • 402

      Payment Required

      A nonstandard client error status response code that is reserved for future use. The initial aim for creating this code was using it for digital payment systems, however this status code is used very rarely and no standard convention exists.

    • 403

      Forbidden

      The server understood the request but refuses to authorize it. Unlike 401, the client's identity is known to the server.

    • 404

      Not Found

      A classic! The server can not find the requested resource. The URL is not recognized - or - the endpoint is valid but the resource itself does not exist. Servers may also send this response instead of 403 to hide the existence of a resource from an unauthorized client.

    • 405

      Method Not Allowed

      The request method is known by the server but has been disabled for this endpoint and cannot be used. For example, the client sent a GET request instead of a POST.

    • 406

      Not Acceptable

      The target resource does not have a current representation that would be acceptable to the user agent, and the server is unwilling to supply a default representation, after performing "server-driven content negotiation".

    • 407

      Proxy Authentication Required

      Similar to 401 (Unauthorized), but indicates that the client needs to authenticate itself in order to use a proxy.

    • 408

      Request Timeout

      The server did not receive a complete request message within the time that it was prepared to wait.

    • 409

      Conflict

      The request could not be completed due to a conflict with the current state of the resource.

    • 410

      Gone

      Access to the target resource is no longer available at the origin server and that this condition is likely to be permanent.

    • 411

      Length Required

      The server refuses to accept the request without a defined Content-Length.

    • 412

      Precondition Failed

      One or more preconditions given in the request header fields evaluated to false when tested on the server.

    • 413

      Payload Too Large

      The server is refusing to process a request because the request payload is larger than the server is willing or able to process.

    • 414

      URI Too Long

      The server is refusing to service the request because the request-target is longer than the server is willing to interpret.

    • 415

      Unsupported Media Type

      The origin server is refusing to service the request because the payload is in a format not supported by the target resource for this method.

    • 416

      Range Not Satisfiable

      None of the ranges in the request's Range header field overlap the current extent of the selected resource or that the set of ranges requested has been rejected due to invalid ranges or an excessive request of small or overlapping ranges.

    • 417

      Expectation Failed

      The expectation given in the request's Expect header field could not be met by at least one of the inbound servers.

    • 418

      I'm a teapot

      Any attempt to brew coffee with a teapot should result in the error code 418 I'm a teapot.

    • 422

      Unprocessable Entity

      The server understands the content type of the request entity (hence a 415 (Unsupported Media Type) status code is inappropriate), and the syntax of the request entity is correct (thus a 400 (Bad Request) status code is inappropriate) but was unable to process the contained instructions.

    • 423

      Locked

      The source or destination resource of a method is locked.

    • 424

      Failed Dependency

      The method could not be performed on the resource because the requested action depended on another action and that action failed.

    • 426

      Upgrade Required

      The server refuses to perform the request using the current protocol but might be willing to do so after the client upgrades to a different protocol.

    • 428

      Precondition Required

      The origin server requires the request to be conditional.

    • 429

      Too Many Requests

      The user has sent too many requests in a given amount of time ("rate limiting").

    • 431

      Request Header Fields Too Large

      The server is unwilling to process the request because its header fields are too large.

    • 451

      Unavailable For Legal Reasons

      The server is denying access to the resource in response to a legal demand.

  • 5xx Server Error 👎

    The server is aware that it has erred or is incapable of performing the requested method.

    • 500

      Internal Server Error

      The server encountered an unexpected condition that prevented it from fulfilling the request.

    • 501

      Not Implemented

      The server does not support the functionality required to fulfill the request.

    • 502

      Bad Gateway

      The server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while attempting to fulfill the request.

    • 503

      Service Unavailable

      The server is currently unable to handle the request due to a temporary overload or scheduled maintenance, which will likely be alleviated after some delay.

    • 504

      Gateway Time-out

      The server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to access in order to complete the request.

    • 505

      HTTP Version Not Supported

      The server does not support, or refuses to support, the protocol version that was used in the request message.

    • 506

      Variant Also Negotiates

      The server has an internal configuration error: the chosen variant resource is configured to engage in transparent content negotiation itself, and is therefore not a proper end point in the negotiation process.

    • 507

      Insufficient Storage

      The method could not be performed on the resource because the server is unable to store the representation needed to successfully complete the request.

    • 511

      Network Authentication Required

      The client needs to authenticate to gain network access.

A micro project by Patrik Engborg Found an error or missing a status code? Let me know.

Credits & Tech