Skip to main content

HTTP Status Codes

v1.0.0

Browse all HTTP status codes with meaning, RFC reference, and usage guidance.

61 codes found

100Continue
1xx Informational

The server has received the request headers and the client should proceed to send the request body.

Large file upload pre-check

RFC 9110

101Switching Protocols
1xx Informational

The requester has asked the server to switch protocols and the server is acknowledging that it will do so.

WebSocket upgrade

RFC 9110

102Processing
1xx Informational

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

Long-running WebDAV requests

RFC 2518

103Early Hints
1xx Informational

Used to return some response headers before the final HTTP message.

Preload resources while server prepares response

RFC 8297

200OK
2xx Success

The request has succeeded. The meaning of the success depends on the HTTP method.

Successful GET, POST, PUT, DELETE requests

RFC 9110

201Created
2xx Success

The request has succeeded and a new resource has been created as a result.

POST request that creates a new resource

RFC 9110

202Accepted
2xx Success

The request has been received but not yet acted upon. It is non-committal.

Async processing, background jobs

RFC 9110

203Non-Authoritative Information
2xx Success

The returned meta-information is not exactly the same as is available from the origin server.

Transformed response from proxy

RFC 9110

204No Content
2xx Success

The server successfully processed the request and is not returning any content.

DELETE requests, form submissions without redirect

RFC 9110

205Reset Content
2xx Success

The server successfully processed the request, but is not returning any content. The client should reset the document view.

Form reset after submission

RFC 9110

206Partial Content
2xx Success

The server is delivering only part of the resource due to a range header sent by the client.

Video streaming, resumable downloads

RFC 9110

207Multi-Status
2xx Success

The message body that follows is by default an XML message and can contain a number of separate response codes.

WebDAV operations on multiple resources

RFC 4918

208Already Reported
2xx Success

The members of a DAV binding have already been enumerated in a preceding part of the response.

WebDAV responses to avoid redundancy

RFC 5842

226IM Used
2xx Success

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.

Delta encoding

RFC 3229

300Multiple Choices
3xx Redirection

The request has more than one possible response.

Content negotiation, multiple file formats

RFC 9110

301Moved Permanently
3xx Redirection

The URL of the requested resource has been changed permanently. The new URL is given in the response.

Domain migration, URL restructuring (SEO-safe)

RFC 9110

302Found
3xx Redirection

The URI of requested resource has been changed temporarily.

Temporary redirects, login redirects

RFC 9110

303See Other
3xx Redirection

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

Post/Redirect/Get pattern after form submission

RFC 9110

304Not Modified
3xx Redirection

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

Conditional requests, browser caching (ETag/Last-Modified)

RFC 9110

307Temporary Redirect
3xx Redirection

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

Temporary redirects preserving HTTP method

RFC 9110

308Permanent Redirect
3xx Redirection

The resource is now permanently located at another URI. Method and body are preserved.

Permanent redirects that must preserve POST

RFC 7538

400Bad Request
4xx Client Error

The server cannot or will not process the request due to something that is perceived to be a client error.

Invalid request body, malformed parameters

RFC 9110

401Unauthorized
4xx Client Error

The client must authenticate itself to get the requested response.

Missing or invalid authentication credentials

RFC 9110

402Payment Required
4xx Client Error

Reserved for future use. Currently used by some APIs for payment paywalls.

API rate limits, subscription required

RFC 9110

403Forbidden
4xx Client Error

The client does not have access rights to the content. Unlike 401, the client's identity is known.

Insufficient permissions, IP blocklist

RFC 9110

404Not Found
4xx Client Error

The server cannot find the requested resource.

Missing pages, deleted resources, typos in URL

RFC 9110

405Method Not Allowed
4xx Client Error

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

GET on a POST-only endpoint

RFC 9110

406Not Acceptable
4xx Client Error

The server cannot produce a response matching the list of acceptable values defined in the request's headers.

Content negotiation failure

RFC 9110

407Proxy Authentication Required
4xx Client Error

Authentication is needed to be done by a proxy.

Corporate proxy authentication

RFC 9110

408Request Timeout
4xx Client Error

The server would like to shut down this unused connection.

Slow client, idle connection

RFC 9110

409Conflict
4xx Client Error

The request conflicts with the current state of the server.

Duplicate resource creation, version conflicts

RFC 9110

410Gone
4xx Client Error

The requested content has been permanently deleted from server, with no forwarding address.

Permanently deleted resources that should not be crawled

RFC 9110

411Length Required
4xx Client Error

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

Upload endpoints requiring known size

RFC 9110

412Precondition Failed
4xx Client Error

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

Optimistic concurrency control (If-Match header)

RFC 9110

413Content Too Large
4xx Client Error

Request entity is larger than limits defined by server.

File upload size limit exceeded

RFC 9110

414URI Too Long
4xx Client Error

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

Extremely long query strings

RFC 9110

415Unsupported Media Type
4xx Client Error

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

Wrong Content-Type header, unsupported file format

RFC 9110

416Range Not Satisfiable
4xx Client Error

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

Byte range beyond file size

RFC 9110

417Expectation Failed
4xx Client Error

The expectation indicated by the Expect request header field cannot be met by the server.

Server cannot fulfill Expect: 100-continue

RFC 9110

418I'm a teapot
4xx Client Error

The server refuses the attempt to brew coffee with a teapot. An April Fools joke from RFC 2324.

Easter egg responses, joke APIs

RFC 2324

421Misdirected Request
4xx Client Error

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

SNI mismatch in HTTPS, wrong host in request

RFC 9110

422Unprocessable Content
4xx Client Error

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

Validation errors (wrong type, out-of-range value)

RFC 9110

423Locked
4xx Client Error

The resource that is being accessed is locked.

WebDAV locked files

RFC 4918

424Failed Dependency
4xx Client Error

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

WebDAV batch operations

RFC 4918

425Too Early
4xx Client Error

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

TLS 0-RTT replay protection

RFC 8470

426Upgrade Required
4xx Client Error

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

HTTP → HTTPS upgrade required

RFC 9110

428Precondition Required
4xx Client Error

The origin server requires the request to be conditional.

Preventing lost-update problems

RFC 6585

429Too Many Requests
4xx Client Error

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

API rate limiting

RFC 6585

431Request Header Fields Too Large
4xx Client Error

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

Cookie overflow, extremely large custom headers

RFC 6585

451Unavailable For Legal Reasons
4xx Client Error

The user agent requested a resource that cannot legally be provided.

GDPR takedowns, government censorship

RFC 7725

500Internal Server Error
5xx Server Error

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

Unhandled exceptions, server configuration errors

RFC 9110

501Not Implemented
5xx Server Error

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

Unimplemented HTTP methods

RFC 9110

502Bad Gateway
5xx Server Error

The server, while working as a gateway, got an invalid response from the upstream server.

Proxy failures, upstream server errors

RFC 9110

503Service Unavailable
5xx Server Error

The server is not ready to handle the request. Common causes are a server that is down for maintenance or overloaded.

Planned maintenance, overload protection

RFC 9110

504Gateway Timeout
5xx Server Error

The server is acting as a gateway and cannot get a response in time.

Upstream timeout, slow backend

RFC 9110

505HTTP Version Not Supported
5xx Server Error

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

HTTP/3-only server receiving HTTP/1.1

RFC 9110

506Variant Also Negotiates
5xx Server Error

The server has an internal configuration error: transparent content negotiation results in a circular reference.

Misconfigured content negotiation

RFC 2295

507Insufficient Storage
5xx Server Error

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

WebDAV storage quota exceeded

RFC 4918

508Loop Detected
5xx Server Error

The server detected an infinite loop while processing the request.

WebDAV circular collections

RFC 5842

510Not Extended
5xx Server Error

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

HTTP extension negotiation failure

RFC 2774

511Network Authentication Required
5xx Server Error

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

Captive portal (hotel/airport WiFi login)

RFC 6585