HTTP Status Codes Reference
Searchable reference for all HTTP status codes — 1xx informational through 5xx server errors with descriptions.
100
Continue
Client should continue the request or ignore if already finished.
101
Switching Protocols
Server is switching protocols as requested by Upgrade header.
102
Processing
Server has received the request and is processing it (WebDAV).
103
Early Hints
Used to preload resources while the server prepares a final response.
200
OK
Request succeeded. Default for successful HTTP requests.
201
Created
Request succeeded and a new resource was created.
202
Accepted
Request accepted for processing but not yet completed.
203
Non-Authoritative Information
Returned metadata is from a third-party copy, not the origin.
204
No Content
Request succeeded; no content to return in the body.
205
Reset Content
Client should reset the document view that sent the request.
206
Partial Content
Server delivered only part of the resource due to a Range header.
207
Multi-Status
Body contains multiple status codes for separate operations (WebDAV).
208
Already Reported
Members of a DAV binding already enumerated; not reported again.
226
IM Used
Response represents the result of one or more instance manipulations.
300
Multiple Choices
Multiple options for the resource; user or agent must choose one.
301
Moved Permanently
Resource has a new permanent URL; update links.
302
Found
Resource temporarily located at another URL.
303
See Other
Response can be found at another URL via GET.
304
Not Modified
Resource hasn't changed since last request; use cached copy.
307
Temporary Redirect
Same method must be used to request the new URL.
308
Permanent Redirect
Permanent redirect preserving the request method.
400
Bad Request
Server cannot process due to malformed syntax or invalid parameters.
401
Unauthorized
Authentication required and has failed or not yet been provided.
402
Payment Required
Reserved for future use; sometimes used by payment systems.
403
Forbidden
Authenticated but not authorized to access this resource.
404
Not Found
Server cannot find the requested resource.
405
Method Not Allowed
Request method is not supported for the target resource.
406
Not Acceptable
Server cannot produce a response matching Accept headers.
407
Proxy Authentication Required
Client must first authenticate with the proxy.
408
Request Timeout
Server timed out waiting for the request.
409
Conflict
Request conflicts with current state of the resource.
410
Gone
Resource permanently removed; clients should purge the URL.
411
Length Required
Content-Length header required but not provided.
412
Precondition Failed
Server does not meet one of the preconditions in the request.
413
Payload Too Large
Request entity is larger than the server is willing to process.
414
URI Too Long
Request URI is longer than the server can interpret.
415
Unsupported Media Type
Media format of the requested data is not supported.
416
Range Not Satisfiable
Range specified by Range header cannot be fulfilled.
417
Expectation Failed
Server cannot meet the expectation in the Expect header.
418
I'm a teapot
Server refuses to brew coffee because it is a teapot (RFC 2324).
421
Misdirected Request
Request was directed at a server unable to produce a response.
422
Unprocessable Content
Request well-formed but semantically invalid.
423
Locked
Resource is locked (WebDAV).
424
Failed Dependency
Request failed due to failure of a previous request (WebDAV).
425
Too Early
Server unwilling to risk processing a request that might be replayed.
426
Upgrade Required
Client should switch to a different protocol.
428
Precondition Required
Origin server requires the request to be conditional.
429
Too Many Requests
User has sent too many requests in a given time (rate limiting).
431
Request Header Fields Too Large
Request headers too large for the server to process.
451
Unavailable For Legal Reasons
Resource unavailable due to legal demands.
500
Internal Server Error
Generic server error; something unexpected happened.
501
Not Implemented
Server does not support the functionality required.
502
Bad Gateway
Upstream server returned an invalid response to the gateway.
503
Service Unavailable
Server is unavailable, usually due to maintenance or overload.
504
Gateway Timeout
Upstream server failed to respond in time.
505
HTTP Version Not Supported
HTTP version in the request is not supported.
506
Variant Also Negotiates
Transparent content negotiation resulted in a circular reference.
507
Insufficient Storage
Server unable to store the representation (WebDAV).
508
Loop Detected
Server detected an infinite loop while processing the request.
510
Not Extended
Further extensions to the request are required.
511
Network Authentication Required
Client needs to authenticate to gain network access (captive portal).
Frequently Asked Questions
What's the difference between 401 and 403?
401 Unauthorized means the request lacks valid authentication credentials. 403 Forbidden means the server understood the request and the user is authenticated, but refuses to authorize it.
Should I return 404 or 410?
Return 404 Not Found if the resource may exist elsewhere or in the future. Return 410 Gone if the resource has been permanently removed and clients should purge the URL.