HTTP Status Codes
Every IANA-assigned HTTP status code, grouped by class, with its exact reason phrase.
A status code is the three-digit number at the start of every HTTP response. The phrase next to it is a label for people. Software branches on the number.
The first digit sets the class: 1 informational, 2 success, 3 redirect, 4 client error, 5 server error. Codes come from RFC 9110 and each code's own RFC.
63 rows.
| Code | Phrase | Description |
|---|---|---|
| 100 | Continue | An interim response telling the client the server has received the request headers and hasn't rejected them yet, so the client should go ahead and send the request body (typically after the client sent an Expect: 100-continue header). |
| 101 | Switching Protocols | The server agrees to the protocol change the client asked for in its Upgrade header, for example, upgrading a plain HTTP connection to WebSocket. |
| 102 | Processing | A WebDAV extension telling the client that a long-running request is still being worked on, so the connection isn't mistaken for having stalled. Originally defined by RFC 2518, which RFC 4918 later obsoleted. |
| 103 | Early Hints | Sent before the final response so the client can start acting on header fields (most commonly preloading resources via a Link header) while the server is still assembling the real reply. |
| 200 | OK | The request succeeded. Any body carries the requested resource or the result of the action. |
| 201 | Created | The request succeeded and resulted in one or more new resources being created, usually with a Location header pointing at (one of) the new resource(s). |
| 202 | Accepted | The request has been accepted for processing, but the processing hasn't completed, and, unlike 200, isn't guaranteed to eventually succeed. |
| 203 | Non-Authoritative Information | The request succeeded, but the payload was modified in transit by an intermediary (a transforming proxy) rather than delivered exactly as the origin server sent it. |
| 204 | No Content | The request succeeded and there's deliberately no body to send back, common for a successful DELETE, or a form submission that shouldn't navigate the client anywhere. |
| 205 | Reset Content | The request succeeded and the server wants the user agent to reset the view that submitted it (e.g. clear a form) rather than navigate away. |
| 206 | Partial Content | The server is fulfilling a range request, returning only the requested byte range of the resource (as named in the client's Range header) rather than the whole thing. |
| 207 | Multi-Status | A WebDAV response covering multiple resources from a single request, where the body itself lists a separate status for each resource instead of one status for the whole request. |
| 208 | Already Reported | Used inside a WebDAV multi-status response to avoid re-listing the members of a collection that a previous binding in that same response already enumerated. |
| 226 | IM Used | The server fulfilled a GET request by applying one or more "instance manipulations" (such as a delta/diff encoding) to the resource, and the response is the result of those manipulations rather than the full representation. |
| 300 | Multiple Choices | The target resource has more than one representation, and the response lets the client (or user) choose a preferred one rather than the server picking automatically. |
| 301 | Moved Permanently | The resource has permanently moved to a new URI, and future requests should go straight to the URI given in the response's Location header. |
| 302 | Found | The resource is temporarily available at a different URI, but the client should keep using the original request URI for future requests. |
| 303 | See Other | Directs the client to fetch a different resource, normally with a GET, as the result of the request: the standard way to redirect after a POST so a page refresh doesn't resubmit the form. |
| 304 | Not Modified | A conditional GET request (one carrying an If-Modified-Since/If-None-Match header) found the resource unchanged, so the client's cached copy is still valid and doesn't need to be re-downloaded. |
| 305 | Use Proxy | Deprecated: told the client it had to access the requested resource only through the proxy given in the response's Location header. |
| 306 | (Unused) | Reserved: the current spec states it must not be used by implementations. An expired 1996 HTTP/1.1 draft had assigned it to a proxy-redirection scheme nicknamed "Switch Proxy," which was never standardized and was dropped over security concerns. |
| 307 | Temporary Redirect | Like 302, the resource is temporarily at a different URI, but unlike 302 the client must repeat the request with the exact same method and body it originally used. |
| 308 | Permanent Redirect | Like 301, the resource has permanently moved, but unlike 301 the client must repeat the request with the exact same method and body it originally used. |
| 400 | Bad Request | The server can't or won't process the request because of something it perceives as a client-side problem (malformed syntax, invalid request framing, or similar) without a more specific 4xx code fitting better. |
| 401 | Unauthorized | No valid credentials for the target resource. The WWW-Authenticate header tells the client how to authenticate. |
| 402 | Payment Required | Reserved for future use, for a request that has not been applied because payment is required and the client hasn't made payment. The spec keeps the code number set aside, but no standardized payment scheme has ever been built on top of it. |
| 403 | Forbidden | The server understood the request and refuses to fulfill it, unlike 401, authenticating (again) won't help; the client simply lacks permission for this resource. |
| 404 | Not Found | The origin server has no current representation for the target resource, and deliberately isn't saying whether that's temporary or permanent. |
| 405 | Method Not Allowed | The request's HTTP method is known to the server but isn't supported by this particular target resource; the response's Allow header lists which methods are. |
| 406 | Not Acceptable | The target resource has no representation that would be acceptable given the Accept-family headers the client sent. |
| 407 | Proxy Authentication Required | The same idea as 401, but the client needs to authenticate to a proxy in the request path before that proxy will forward the request onward. |
| 408 | Request Timeout | The client didn't finish sending its request in time, so the server closed the connection. |
| 409 | Conflict | The request conflicts with the resource's current state, such as two concurrent edits colliding. |
| 410 | Gone | The target resource used to exist here but is no longer available, and this condition is believed to be permanent: a deliberately stronger statement than a plain 404. |
| 411 | Length Required | The request arrived with no Content-Length, and the server requires one. |
| 412 | Precondition Failed | One or more conditional request headers (such as If-Match or If-Unmodified-Since) evaluated to false when tested against the resource's current state. |
| 413 | Content Too Large | The server refuses to process the request because its content is larger than the server is willing or able to handle. RFC 9110 renamed this from the older "Payload Too Large" phrase, which is still what many implementations display. |
| 414 | URI Too Long | The request URI is longer than the server is willing to interpret. |
| 415 | Unsupported Media Type | The request content's format isn't supported by this method on this resource. |
| 416 | Range Not Satisfiable | The Range header asks for bytes the resource doesn't have. |
| 417 | Expectation Failed | The expectation stated in the request's Expect header field couldn't be met by the server (or by a proxy in the request chain). |
| 418 | (Unused) | Reserved and formally unassigned. It originated as an April Fools' joke in 1998's RFC 2324, "Hyper Text Coffee Pot Control Protocol," and RFC 9110 later reserved the number outright, in part because the joke had already been implemented so widely. |
| 421 | Misdirected Request | The request was directed at a server that can't produce an authoritative response for the target URI: the code most commonly surfaces when a client reuses an HTTP/2 connection across origins (connection coalescing) and the server isn't actually configured for the requested one. |
| 422 | Unprocessable Content | The server understands the request's content type and syntax but can't act on the instructions it contains, e.g. a well-formed JSON body that fails validation. Originally a WebDAV-only code named "Unprocessable Entity" (RFC 4918); RFC 9110 folded it into core HTTP semantics under this renamed phrase. |
| 423 | Locked | The resource is locked, and the request needs the right lock token. |
| 424 | Failed Dependency | The request failed because it depended on the outcome of another request within the same operation, and that other request failed first. |
| 425 | Too Early | The server isn't willing to risk processing a request that arrived as TLS 1.3 "early data" before the full handshake completed, since early data can potentially be captured and replayed by an attacker. |
| 426 | Upgrade Required | The server refuses to complete the request using the current protocol and requires the client to upgrade to a different one, typically paired with an Upgrade header naming the required protocol. |
| 428 | Precondition Required | The origin server requires the request to be conditional (carry an If-Match-style header), to prevent the "lost update" problem where two clients unknowingly overwrite each other's changes. |
| 429 | Too Many Requests | Too many requests in too little time. The standard rate-limiting code. |
| 431 | Request Header Fields Too Large | The request's header fields are too large, individually or in total. |
| 451 | Unavailable For Legal Reasons | Access is denied because of a legal demand, such as a government takedown order. |
| 500 | Internal Server Error | The server hit an unexpected condition and couldn't fulfill the request. It's the catch-all when no more specific 5xx fits. |
| 501 | Not Implemented | The server doesn't support what the request needs, such as an unrecognized method. |
| 502 | Bad Gateway | The server, while acting as a gateway or proxy, received an invalid response from an inbound server it was trying to fulfill the request through. |
| 503 | Service Unavailable | The server can't handle the request right now, usually from temporary overload or maintenance. Often paired with a Retry-After header. |
| 504 | Gateway Timeout | The server, while acting as a gateway or proxy, didn't receive a timely response from an inbound server it needed to complete the request. |
| 505 | HTTP Version Not Supported | The server doesn't support the request's major HTTP version. |
| 506 | Variant Also Negotiates | A server misconfiguration: the resource chosen by transparent content negotiation is itself configured to perform content negotiation, so it isn't a valid negotiation endpoint. |
| 507 | Insufficient Storage | The server is out of storage space to complete the request. |
| 508 | Loop Detected | The server terminated the operation because it encountered an infinite loop while processing a WebDAV request with a Depth: infinity header. |
| 510 | Not Extended | The policy for accessing the resource hadn't been met by the request, and the server wanted the client to resend it with a required extension the response would describe. Defined by RFC 2774's HTTP Extension Framework, which never saw meaningful adoption and is now Historic. |
| 511 | Network Authentication Required | Sent by an intercepting proxy (the canonical example being a captive portal) to indicate the client needs to authenticate for network access before its request can go through. |