ThakurCoder
HTTP Status Code Reference
Complete reference of HTTP status codes with descriptions and common usage examples
ℹ️
1xx
Informational
Request received, continuing process
4 codes
2xx
Successful
Request successfully received, understood, and accepted
10 codes
🔄
3xx
Redirection
Further action must be taken to complete the request
7 codes
⚠️
4xx
Client Error
Request contains bad syntax or cannot be fulfilled
29 codes
💥
5xx
Server Error
Server failed to fulfill an apparently valid request
11 codes
100
Informational

Continue

The client should continue the request or ignore if already finished.

Common usage: Used in HTTP/1.1 for request continuation
🔄
101
Informational

Switching Protocols

The server understands and is willing to comply with the client's request for a change in the application protocol.

Common usage: WebSocket upgrades, HTTP/2 upgrades
⚙️
102
Informational

Processing
Deprecated

The server has received and is processing the request, but no response is available yet.

Common usage: WebDAV operations
💡
103
Informational

Early Hints

Used to return some response headers before final HTTP message.

Common usage: Preloading resources while server prepares response
200
Successful

OK

The request succeeded. The result meaning depends on the HTTP method.

Common usage: Most common success response for GET, POST, PUT requests
🆕
201
Successful

Created

The request succeeded, and a new resource was created as a result.

Common usage: POST requests that create new resources
📝
202
Successful

Accepted

The request has been received but not yet acted upon.

Common usage: Asynchronous processing, batch operations
📋
203
Successful

Non-Authoritative Information

The returned metadata is not exactly the same as is available from the origin server.

Common usage: Proxy responses, cached content
📭
204
Successful

No Content

There is no content to send for this request, but the headers may be useful.

Common usage: DELETE operations, PUT updates
🔄
205
Successful

Reset Content

Tells the user agent to reset the document which sent this request.

Common usage: Form submissions that reset form data
📦
206
Successful

Partial Content

This response code is used when the Range header is sent from the client.

Common usage: Video streaming, file downloads with range requests
📊
207
Successful

Multi-Status

Conveys information about multiple resources in situations where multiple status codes might be appropriate.

Common usage: WebDAV operations on multiple resources
📌
208
Successful

Already Reported

Used inside a DAV: propstat response element to avoid enumerating the internal members of multiple bindings.

Common usage: WebDAV to prevent resource duplication
🎯
226
Successful

IM Used

The server has fulfilled a request for the resource, and the response is a representation of the result.

Common usage: HTTP Delta encoding
🤔
300
Redirection

Multiple Choices

The request has more than one possible response.

Common usage: Content negotiation, multiple format options
📍
301
Redirection

Moved Permanently

The URL of the requested resource has been changed permanently.

Common usage: SEO redirects, URL restructuring
🔍
302
Redirection

Found

The URI of requested resource has been changed temporarily.

Common usage: Temporary redirects, A/B testing
👀
303
Redirection

See Other

The server sent this response to direct the client to get the requested resource with a GET request.

Common usage: POST-redirect-GET pattern
💾
304
Redirection

Not Modified

This is used for caching purposes. It tells the client that the response has not been modified.

Common usage: Browser caching, ETags, Last-Modified headers
↩️
307
Redirection

Temporary Redirect

The server sends this response to direct the client to get the requested resource with the same method.

Common usage: Preserving HTTP method during redirect
🏠
308
Redirection

Permanent Redirect

This means that the resource is now permanently located at another URI.

Common usage: HTTPS upgrades, permanent URL changes
400
Client Error

Bad Request

The server cannot or will not process the request due to an apparent client error.

Common usage: Invalid JSON, malformed requests, validation errors
🔐
401
Client Error

Unauthorized

The client must authenticate itself to get the requested response.

Common usage: Missing or invalid authentication credentials
💳
402
Client Error

Payment Required

This response code is reserved for future use.

Common usage: Digital payment systems (rare usage)
🚫
403
Client Error

Forbidden

The client does not have access rights to the content.

Common usage: Insufficient permissions, blocked IP addresses
🔍
404
Client Error

Not Found

The server can not find the requested resource.

Common usage: Missing pages, deleted resources, typos in URLs
405
Client Error

Method Not Allowed

The request method is known by the server but not supported by the target resource.

Common usage: Using POST on GET-only endpoints
🙅
406
Client Error

Not Acceptable

This response is sent when the web server cannot find any content conforming to the criteria given by the user agent.

Common usage: Content negotiation failures
🔒
407
Client Error

Proxy Authentication Required

This is similar to 401 but authentication is needed to be done by a proxy.

Common usage: Corporate proxy authentication
408
Client Error

Request Timeout

This response is sent on an idle connection by some servers.

Common usage: Slow client requests, network timeouts
409
Client Error

Conflict

This response is sent when a request conflicts with the current state of the server.

Common usage: Resource conflicts, version conflicts
👻
410
Client Error

Gone

This response is sent when the requested content has been permanently deleted from server.

Common usage: Permanently removed resources
📏
411
Client Error

Length Required

Server rejected the request because the Content-Length header field is not defined.

Common usage: Missing Content-Length in POST/PUT requests
🚧
412
Client Error

Precondition Failed

The client has indicated preconditions in its headers which the server does not meet.

Common usage: Conditional requests, ETags, If-Match headers
📦
413
Client Error

Payload Too Large

Request entity is larger than limits defined by server.

Common usage: File uploads exceeding size limits
📝
414
Client Error

URI Too Long

The URI requested by the client is longer than the server is willing to interpret.

Common usage: Very long query parameters or URLs
🎭
415
Client Error

Unsupported Media Type

The media format of the requested data is not supported by the server.

Common usage: Unsupported file formats, incorrect Content-Type
📊
416
Client Error

Range Not Satisfiable

The range specified by the Range header field in the request cannot be fulfilled.

Common usage: Invalid byte ranges in Range requests
🎯
417
Client Error

Expectation Failed

This response code means the expectation indicated by the Expect request header field cannot be met.

Common usage: Failed Expect: 100-continue
🫖
418
Client Error

I'm a teapot

The server refuses the attempt to brew coffee with a teapot.

Common usage: April Fools RFC joke, sometimes used for Easter eggs
🧭
421
Client Error

Misdirected Request

The request was directed at a server that is not able to produce a response.

Common usage: HTTP/2 connection issues
🔧
422
Client Error

Unprocessable Entity

The request was well-formed but was unable to be followed due to semantic errors.

Common usage: Validation errors, business logic failures
🔐
423
Client Error

Locked

The resource that is being accessed is locked.

Common usage: WebDAV locked resources
🔗
424
Client Error

Failed Dependency

The request failed because it depended on another request and that request failed.

Common usage: WebDAV dependent operations
425
Client Error

Too Early

Indicates that the server is unwilling to risk processing a request that might be replayed.

Common usage: HTTP/3 early data prevention
⬆️
426
Client Error

Upgrade Required

The server refuses to perform the request using the current protocol.

Common usage: Force HTTPS upgrades, protocol upgrades
🎯
428
Client Error

Precondition Required

The origin server requires the request to be conditional.

Common usage: Preventing lost update problems
🚦
429
Client Error

Too Many Requests

The user has sent too many requests in a given amount of time.

Common usage: Rate limiting, API throttling
📋
431
Client Error

Request Header Fields Too Large

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

Common usage: Large cookie headers, excessive custom headers
⚖️
451
Client Error

Unavailable For Legal Reasons

The server is denying access to the resource as a consequence of a legal demand.

Common usage: Censorship, legal content removal, DMCA takedowns
💥
500
Server Error

Internal Server Error

The server has encountered a situation it does not know how to handle.

Common usage: Unhandled exceptions, server crashes, code bugs
🚧
501
Server Error

Not Implemented

The request method is not supported by the server and cannot be handled.

Common usage: Unsupported HTTP methods, unimplemented features
🌉
502
Server Error

Bad Gateway

This error response means that the server got an invalid response while working as a gateway.

Common usage: Proxy errors, upstream server failures
🔧
503
Server Error

Service Unavailable

The server is not ready to handle the request.

Common usage: Maintenance mode, overloaded servers, temporary outages
⏱️
504
Server Error

Gateway Timeout

This error response is given when the server is acting as a gateway and cannot get a response in time.

Common usage: Slow upstream servers, network timeouts
📊
505
Server Error

HTTP Version Not Supported

The HTTP version used in the request is not supported by the server.

Common usage: Outdated HTTP protocol versions
🔄
506
Server Error

Variant Also Negotiates

The server has an internal configuration error.

Common usage: Content negotiation misconfigurations
💿
507
Server Error

Insufficient Storage

The server is unable to store the representation needed to complete the request.

Common usage: WebDAV storage limits, disk space issues
🔁
508
Server Error

Loop Detected

The server detected an infinite loop while processing the request.

Common usage: WebDAV circular references
🔧
510
Server Error

Not Extended

Further extensions to the request are required for the server to fulfill it.

Common usage: HTTP Extension Framework
📡
511
Server Error

Network Authentication Required

Indicates that the client needs to authenticate to gain network access.

Common usage: Captive portals, public WiFi authentication

About HTTP Status Codes

HTTP status codes are issued by a server in response to a client's request. They indicate whether the request was successful, redirected, resulted in an error, or requires further action. Each status code is a 3-digit number where the first digit defines the class of response.

Total: 61 codes
Source: MDN Web Docs