Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

response status codes

The IANA maintains the Hypertext Transfer Protocol (HTTP) Status Code Registry

1xx: Informational

Request received, continuing process

CodeStatusDescriptionDefining Reference
100ContinueRFC7231
101Switching ProtocolsRFC7231
102ProcessingRFC2518

2xx: Success

The action was successfully received, understood, and accepted

CodeStatusDescriptionDefining Reference
200OKRFC7231, Section 6.3.1
201CreatedThe request succeeded and resulted in a new resource being createdRFC7231, Section 6.3.2
202AcceptedThe request has been accepted, but will be processed at a later timeRFC7231, Section 6.3.3
203Non-Authoritative InformationA response is made using information for which another server is the authoritative sourceRFC7231, Section 6.3.4
204No ContentThe request succeeded and no entity-body needs to be returned, though information might be sent in headersRFC7231, Section 6.3.5
205Reset ContentThe request succeeded and the user-agent should take the user back to the start to enter another requestRFC7231, Section 6.3.6
206Partial ContentThe response contains only a subset of the entire resourceRFC7233, Section 4.1
207Multi-StatusRFC4918
208Already ReportedRFC5842
226IM UsedRFC3229

3xx: Redirection

Further action must be taken in order to complete the request

CodeStatusDescriptionDefining Reference
300Multiple ChoicesThe requested resource corresponds to any one of a set of representationsRFC7231, Section 6.4.1
301Moved PermanentlyThe requested resource has been assigned a new permanent URIRFC7231, Section 6.4.2
302FoundThe requested resource resides temporarily under a different URI (with ambiguous behavior, 307 is suggested instead)RFC7231, Section 6.4.3
303See OtherThe response to the request can be found under a different URI and SHOULD be retrieved using a GET method on that resourceRFC7231, Section 6.4.4
304Not ModifiedThe request is successful, and no entity-body is sent because the user-agent’s cached version is up to dateRFC7232, Section 4.1
305Use ProxyThe requested resource MUST be accessed through the proxy given by the Location field (deprecated)RFC7231, Section 6.4.5
306Reserved(Unused)RFC7231, Section 6.4.6
307Temporary RedirectThe request should be re-made to a different URIRFC7231, Section 6.4.7
308Permanent RedirectThe request should be re-made to the resource’s new URIRFC7238

4xx: Client Error

The request contains bad syntax or cannot be fulfilled

CodeStatusDescriptionDefining Reference
400Bad RequestThe server cannot process the request due to a client errorRFC7231, Section 6.5.1
401UnauthorizedThe request lacks valid authentication credentialsRFC7235, Section 3.1
402Payment Required(Unused)RFC7231, Section 6.5.2
403ForbiddenThe server understood the request but refuses to authorize itRFC7231, Section 6.5.3
404Not FoundThe server does not know about such a resourceRFC7231, Section 6.5.4
405Method Not AllowedThe request method can’t be applied to the resourceRFC7231, Section 6.5.5
406Not AcceptableRFC7231, Section 6.5.6
407Proxy Authentication RequiredThe client must authenticate itself to the proxyRFC7235, Section 3.2
408Request TimeoutThe server didn’t receive a complete request in a timely mannerRFC7231, Section 6.5.7
409ConflictThe request could not be completed due to a conflict with the current state of the target resourceRFC7231, Section 6.5.8
410GoneThe requested resource no longer existsRFC7231, Section 6.5.9
411Length RequiredThe server refuses to accept an upload without being told its Content-LengthRFC7231, Section 6.5.10
412Precondition FailedThe request was not processed because conditions requested by the client were evaluated false by the serverRFC7232, Section 4.2
413Request Entity Too Largethe request payload is larger than the server is willing or able to processRFC7231, Section 6.5.11
414Request-URI Too LongThe request-target is longer than the server is willing to interpretRFC7231, Section 6.5.12
415Unsupported Media TypeThe payload is in a format not supported by this method on the target resourceRFC7231, Section 6.5.13
416Requested Range Not SatisfiableA problem with the request’s Range headerRFC7233, Section 4.4
417Expectation FailedAn expectation in the request Expect could not be filled by a server.RFC7231, Section 6.5.14
422Unprocessable EntityRFC4918
423LockedRFC4918
424Failed DependencyRFC4918
426Upgrade RequiredThe server might be able to fill the request after changing protocolsRFC7231, Section 6.5.15
428Precondition RequiredThe server requests a conditional request header such as If-Match to prevent “lost updates”RFC6585
429Too Many RequestsThe client has exceeded a request rate limit imposed by the server. Enhance your calm!RFC6585
431Request Header Fields Too LargeRFC6585

5xx: Server Error

The server failed to fulfill an apparently valid request

CodeStatusDescriptionDefining Reference
500Internal Server ErrorThe server encountered an unexpected condition that prevented it from fulfilling the requestRFC7231, Section 6.6.1
501Not ImplementedThe server does not support the functionality required to fulfill the requestRFC7231, Section 6.6.2
502Bad GatewayA server encountered a problem forwarding the requestRFC7231, Section 6.6.3
503Service UnavailableThe server is currently unable to handle the request due to a temporary overload or scheduled maintenanceRFC7231, Section 6.6.4
504Gateway TimeoutThe server, while acting as a gateway or proxy, did not receive a timely response from an upstream serverRFC7231, Section 6.6.5
505HTTP Version Not SupportedThe server does not support, or refuses to support, the major version of HTTP that was used in the request messageRFC7231, Section 6.6.6
506Variant Also Negotiates (Experimental)Indicates an error in the server’s configuration of Content-Type negotiationRFC2295
507Insufficient StorageThe server encountered an internal error while storing dataRFC4918
508Loop DetectedRFC5842
510Not Extended(Experimental)RFC2774
511Network Authentication RequiredFor use by “captive portals”RFC6585