HTTP Status Code Reference

Instant lookup for HTTP status codes. Search by code to see title, description, and when to use.

Search by code (e.g. 404, 500)...

All Codes (63)

Examples of use

Look up what a 429 status code means when debugging rate limiting
Quickly reference status codes when writing API error handling
Check the correct status code to return for a new API endpoint

When to use this tool?

When debugging API responses and need to understand a status code
When implementing error handling and need the right response codes
When writing API documentation that references status codes

Frequently asked questions

What are HTTP status codes?: HTTP status codes are three-digit numbers returned by a server in response to a client's request. They indicate whether the request was successful, redirected, or resulted in an error.
What do the categories mean?: 1xx are informational, 2xx indicate success, 3xx are redirections, 4xx are client errors (bad request, not found, etc.), and 5xx are server errors (internal error, service unavailable, etc.).

Code	Title	Description
100	Continue The server has received the request headers and the client should proceed to send the request body.	The server has received the request headers and the client should proceed to send the request body.
101	Switching Protocols The server is switching protocols as requested by the client via the Upgrade header.	The server is switching protocols as requested by the client via the Upgrade header.
102	Processing The server has received and is processing the request, but no response is available yet.	The server has received and is processing the request, but no response is available yet.
103	Early Hints Used to return some response headers before final HTTP message.	Used to return some response headers before final HTTP message.
200	OK The request has succeeded. The meaning depends on the method used.	The request has succeeded. The meaning depends on the method used.
201	Created The request has been fulfilled and resulted in a new resource being created.	The request has been fulfilled and resulted in a new resource being created.
202	Accepted The request has been accepted for processing, but the processing has not been completed.	The request has been accepted for processing, but the processing has not been completed.
203	Non-Authoritative Information The request was successful, but the returned meta-information is not from the original server.	The request was successful, but the returned meta-information is not from the original server.
204	No Content The server successfully processed the request and is not returning any content.	The server successfully processed the request and is not returning any content.
205	Reset Content The server successfully processed the request, but is not returning any content.	The server successfully processed the request, but is not returning any content.
206	Partial Content The server is delivering only part of the resource due to a Range header in the request.	The server is delivering only part of the resource due to a Range header in the request.
207	Multi-Status The message body that follows is an XML message and can contain a number of separate response codes.	The message body that follows is an XML message and can contain a number of separate response codes.
208	Already Reported The members of a DAV binding have already been enumerated in a previous reply.	The members of a DAV binding have already been enumerated in a previous reply.
226	IM Used 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.	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.
300	Multiple Choices Indicates multiple options for the resource from which the client may choose.	Indicates multiple options for the resource from which the client may choose.
301	Moved Permanently This and all future requests should be directed to the given URI.	This and all future requests should be directed to the given URI.
302	Found Tells the client to look at another URL.	Tells the client to look at another URL.
303	See Other The response to the request can be found under another URI using a GET method.	The response to the request can be found under another URI using a GET method.
304	Not Modified Indicates the resource has not been modified since the version specified by the request headers.	Indicates the resource has not been modified since the version specified by the request headers.
305	Use Proxy The requested resource is available only through a proxy.	The requested resource is available only through a proxy.
306	Unused This status code was used in a previous version of the specification but is now unused.	This status code was used in a previous version of the specification but is now unused.
307	Temporary Redirect The request should be repeated with another URI but future requests should still use the original URI.	The request should be repeated with another URI but future requests should still use the original URI.
308	Permanent Redirect The request and all future requests should be repeated using another URI.	The request and all future requests should be repeated using another URI.
400	Bad Request The server cannot or will not process the request due to an apparent client error.	The server cannot or will not process the request due to an apparent client error.
401	Unauthorized Authentication is required and has either failed or not been provided.	Authentication is required and has either failed or not been provided.
402	Payment Required Reserved for future use.	Reserved for future use.
403	Forbidden The request was valid, but the server is refusing action.	The request was valid, but the server is refusing action.
404	Not Found The requested resource could not be found but may be available in the future.	The requested resource could not be found but may be available in the future.
405	Method Not Allowed A request method is not supported for the requested resource.	A request method is not supported for the requested resource.
406	Not Acceptable The requested resource is capable of generating content not acceptable according to the Accept headers.	The requested resource is capable of generating content not acceptable according to the Accept headers.
407	Proxy Authentication Required The client must first authenticate itself with the proxy.	The client must first authenticate itself with the proxy.
408	Request Timeout The server timed out waiting for the request from the client.	The server timed out waiting for the request from the client.
409	Conflict Indicates that the request could not be processed because of conflict in the current state of the resource.	Indicates that the request could not be processed because of conflict in the current state of the resource.
410	Gone Indicates that the resource requested is no longer available and will not be available again.	Indicates that the resource requested is no longer available and will not be available again.
411	Length Required The request did not specify the length of its content, which is required by the requested resource.	The request did not specify the length of its content, which is required by the requested resource.
412	Precondition Failed The server does not meet one of the preconditions that the requester put on the request.	The server does not meet one of the preconditions that the requester put on the request.
413	Content Too Large The request is larger than the server is willing or able to process.	The request is larger than the server is willing or able to process.
414	URI Too Long The URI provided was too long for the server to process.	The URI provided was too long for the server to process.
415	Unsupported Media Type The request entity has a media type which the server or resource does not support.	The request entity has a media type which the server or resource does not support.
416	Range Not Satisfiable The client has asked for a portion of the file, but the server cannot supply that portion.	The client has asked for a portion of the file, but the server cannot supply that portion.
417	Expectation Failed The server cannot meet the requirements of the Expect request-header field.	The server cannot meet the requirements of the Expect request-header field.
418	I'm a Teapot The server refuses the attempt to brew coffee with a teapot.	The server refuses the attempt to brew coffee with a teapot.
421	Misdirected Request The request was directed at a server that is not able to produce a response.	The request was directed at a server that is not able to produce a response.
422	Unprocessable Content The request was well-formed but was unable to be followed due to semantic errors.	The request was well-formed but was unable to be followed due to semantic errors.
423	Locked The resource that is being accessed is locked.	The resource that is being accessed is locked.
424	Failed Dependency The request failed because it depended on another request and that request failed.	The request failed because it depended on another request and that request failed.
425	Too Early Indicates that the server is unwilling to risk processing a request that might be replayed.	Indicates that the server is unwilling to risk processing a request that might be replayed.
426	Upgrade Required The client should switch to a different protocol.	The client should switch to a different protocol.
428	Precondition Required The origin server requires the request to be conditional.	The origin server requires the request to be conditional.
429	Too Many Requests The user has sent too many requests in a given amount of time.	The user has sent too many requests in a given amount of time.
431	Request Header Fields Too Large The server is unwilling to process the request because either an individual header field, or all the header fields collectively, are too large.	The server is unwilling to process the request because either an individual header field, or all the header fields collectively, are too large.
451	Unavailable For Legal Reasons A server operator has received a legal demand to deny access to a resource.	A server operator has received a legal demand to deny access to a resource.
500	Internal Server Error A generic error message, given when an unexpected condition was encountered.	A generic error message, given when an unexpected condition was encountered.
501	Not Implemented The server either does not recognize the request method, or it lacks the ability to fulfil the request.	The server either does not recognize the request method, or it lacks the ability to fulfil the request.
502	Bad Gateway The server was acting as a gateway or proxy and received an invalid response from the upstream server.	The server was acting as a gateway or proxy and received an invalid response from the upstream server.
503	Service Unavailable The server cannot handle the request (because it is overloaded or down for maintenance).	The server cannot handle the request (because it is overloaded or down for maintenance).
504	Gateway Timeout The server was acting as a gateway or proxy and did not receive a timely response from the upstream server.	The server was acting as a gateway or proxy and did not receive a timely response from the upstream server.
505	HTTP Version Not Supported The server does not support the HTTP protocol version used in the request.	The server does not support the HTTP protocol version used in the request.
506	Variant Also Negotiates Transparent content negotiation for the request results in a circular reference.	Transparent content negotiation for the request results in a circular reference.
507	Insufficient Storage The server is unable to store the representation needed to complete the request.	The server is unable to store the representation needed to complete the request.
508	Loop Detected The server detected an infinite loop while processing the request.	The server detected an infinite loop while processing the request.
510	Not Extended Further extensions to the request are required for the server to fulfil it.	Further extensions to the request are required for the server to fulfil it.
511	Network Authentication Required The client needs to authenticate to gain network access.	The client needs to authenticate to gain network access.