Back to Developer Tools

HTTP Status Code Lookup & Dictionary

Browse, search, and filter HTTP response status code specifications, categories, and common usages.

100Continue
Info

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

Common Usage:Used in large file uploads with Expect headers to check if the server is ready.
101Switching Protocols
Info

The requester has asked the server to switch protocols and the server has agreed to do so.

Common Usage:Used when upgrading HTTP connections to WebSockets.
200OK
Success

Standard response for successful HTTP requests. The actual response will depend on the request method used.

Common Usage:GET, PUT, or POST requests succeeded.
201Created
Success

The request has been fulfilled, resulting in the creation of a new resource.

Common Usage:Returned after a successful POST request creating a record.
202Accepted
Success

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

Common Usage:Used in async background tasks/queue processing.
204No Content
Success

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

Common Usage:Used in successful DELETE requests or empty PUT saves.
301Moved Permanently
Redirect

This and all future requests should be directed to the given URI.

Common Usage:Used when redirecting HTTP to HTTPS permanently.
302Found
Redirect

Tells the client to look at another URL temporarily. (Previously 'Moved Temporarily').

Common Usage:Used for temporary page redirects.
304Not Modified
Redirect

Indicates that the resource has not been modified since the version specified by the request headers If-Modified-Since or If-None-Match.

Common Usage:Used for HTTP caching optimizations.
400Bad Request
Client

The server cannot or will not process the request due to an apparent client error (e.g., malformed request syntax, size too large, invalid request message framing, or deceptive request routing).

Common Usage:Returned when client provides malformed JSON payload or missing arguments.
401Unauthorized
Client

Similar to 403 Forbidden, but specifically for use when authentication is required and has failed or has not yet been provided.

Common Usage:Returned when request lacks valid JWT or authorization headers.
403Forbidden
Client

The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource, or may need an account of some sort.

Common Usage:Returned when a standard user tries to perform admin commands.
404Not Found
Client

The requested resource could not be found but may be available in the future. Subsequent requests by the client are permissible.

Common Usage:Returned when a specific URL route or resource ID doesn't exist.
405Method Not Allowed
Client

A request method is not supported for the requested resource (e.g., a GET request on a POST endpoint).

Common Usage:Returned when calling GET on a POST-only authentication endpoint.
409Conflict
Client

Indicates that the request could not be processed because of conflict in the current state of the resource.

Common Usage:Returned when signing up with an email that is already registered.
422Unprocessable Content
Client

The request was well-formed but was unable to be followed due to semantic errors (e.g. invalid Pydantic body validation).

Common Usage:Returned by FastAPI when input schema validation fails.
429Too Many Requests
Client

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

Common Usage:Returned when API clients hit IP request thresholds.
500Internal Server Error
Server

A generic error message, given when an unexpected condition was encountered and no more specific message is suitable.

Common Usage:Returned when backend codes crash, unhandled exceptions occur, etc.
502Bad Gateway
Server

The server was acting as a gateway or proxy and received an invalid response from the upstream server.

Common Usage:Returned when Nginx/proxy loses connection to the backend application server.
503Service Unavailable
Server

The server cannot handle the request (because it is overloaded or down for maintenance). Generally, this is a temporary state.

Common Usage:Returned during rolling server updates or database maintenance windows.
504Gateway Timeout
Server

The server was acting as a gateway or proxy and did not receive a timely response from the upstream server.

Common Usage:Returned when a backend query runs longer than proxy threshold limits (e.g., 60 seconds).

What are HTTP Status Codes?

HTTP response status codes indicate whether a specific HTTP request has been successfully completed. Responses are grouped in five classes:

  • 1xx Informational: Request received, continuing process.
  • 2xx Success: The action was successfully received, understood, and accepted.
  • 3xx Redirection: Further action must be taken in order to complete the request.
  • 4xx Client Error: The request contains bad syntax or cannot be fulfilled.
  • 5xx Server Error: The server failed to fulfill an apparently valid request.