HTTP Status Codes Reference

This page provides a comprehensive overview of HTTP status codes, categorized by their response class. Understanding these codes is crucial for diagnosing and debugging network communication issues.

1xx Informational

The request was received, continuing process.

100 Continue

Description: The server has received the request headers and the client should proceed with sending the request body.

RFC: RFC 7231

101 Switching Protocols

Description: The server understands and will comply with the client's request to switch protocols.

RFC: RFC 7231

102 Processing

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

RFC: RFC 2518

2xx Success

The action was successfully received, understood, and accepted.

200 OK

Description: The request has succeeded.

RFC: RFC 7231

201 Created

Description: The request has been fulfilled and resulted in a new resource being created.

RFC: RFC 7231

202 Accepted

Description: The request has been accepted for processing, but the processing has not been completed.

RFC: RFC 7231

204 No Content

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

RFC: RFC 7231

3xx Redirection

Further action needs to be taken by the user agent in order to complete the request.

301 Moved Permanently

Description: The requested resource has been permanently moved to a new URL. The client should use the new URL for future requests.

RFC: RFC 7231

302 Found

Description: The requested resource is temporarily located at a different URL. The client should try again at the original URL.

RFC: RFC 7231

304 Not Modified

Description: The client has performed a conditional request for a resource and the resource has not been modified.

RFC: RFC 7232

4xx Client Error

The request contains bad syntax or cannot be fulfilled.

400 Bad Request

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

RFC: RFC 7231

401 Unauthorized

Description: The request requires user authentication. The client must authenticate itself to get the requested response.

RFC: RFC 7235

403 Forbidden

Description: The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested information.

RFC: RFC 7231

404 Not Found

Description: The server cannot find the requested resource. This error is common and indicates that the URL entered is incorrect or the resource has been moved or deleted.

RFC: RFC 7231

405 Method Not Allowed

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

RFC: RFC 7231

409 Conflict

Description: The request could not be completed because of a conflict with the current state of the target resource.

RFC: RFC 7231

410 Gone

Description: Indicates that the resource requested is no longer available and will not be available again. This should be used when the resource has been deliberately removed and the owner wants to make sure that the resource is not accessible by forwarding the client to an alternative resource.

RFC: RFC 7231

429 Too Many Requests

Description: The user has sent too many requests in a given amount of time. This is often used as part of a rate-limiting strategy.

RFC: RFC 6585

5xx Server Error

The server failed to fulfill an apparently valid request.

500 Internal Server Error

Description: A generic error message, given when no more specific message is suitable. This indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.

RFC: RFC 7231

501 Not Implemented

Description: The server does not support the functionality required to fulfill the request.

RFC: RFC 7231

502 Bad Gateway

Description: The server, while acting as a gateway or proxy, received an invalid response from the upstream server.

RFC: RFC 7231

503 Service Unavailable

Description: The server is currently unable to handle the request due to temporary overloading or maintenance of the server.

RFC: RFC 7231

504 Gateway Timeout

Description: The server, while acting as a gateway or proxy, did not get a response in time from the upstream server.

RFC: RFC 7231