Informational (1xx)

Indicates that the request has been received and the process is continuing.

๐Ÿ”„

Continue - 100

Informational

This interim response indicates that the client should continue the request or ignore the response if the request is already finished.

Tip: Used when a request is large and the client is waiting for confirmation to continue.

Example: Client sends headers, server replies with 100 Continue to allow sending body.
Mock Request Body:
{
"fileMetadata": {
"name": "report.pdf",
"size": "2MB"
}
}
Try Mock Request:
๐Ÿ”€

Switching Protocols - 101

Informational

This code is sent in response to an Upgrade request header from the client and indicates the protocol the server is switching to.

Tip: Used to switch protocols like HTTP to WebSocket when requested by the client.

Example: Client requests to upgrade from HTTP/1.1 to WebSocket.
Try Mock Request:
๐ŸŒ€

Processing (Deprecated) - 102

Informational

This code was used in WebDAV contexts to indicate that a request has been received by the server, but no status was available at the time of the response.

Tip: Rarely used. Indicates that processing is ongoing, especially for WebDAV operations.

Example: PROPFIND request in WebDAV returns 102 while processing.
Try Mock Request:
โฉ

Early Hints - 103

Informational

This status code is primarily intended to be used with the Link header, letting the user agent start preloading resources while the server prepares a response.

Tip: Helps browsers preload resources before full response is ready.

Example: Server sends 103 with Link headers before full HTML response.
Try Mock Request:

Success (2xx)

Indicates that the request was successfully received, understood, and accepted.

โœ…

OK - 200

Success

The request succeeded. The result depends on the HTTP method (GET, POST, PUT, etc.).

Tip: The most common status. Everything worked as expected.

Example: GET /api/users returns a list of users.
Try Mock Request:
๐Ÿ†•

Created - 201

Success

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

Tip: Indicates successful creation. Usually follows a POST request.

Example: POST /api/users creates a new user.
Mock Request Body:
{
"name": "Charlie"
}
Try Mock Request:
๐Ÿ“ฌ

Accepted - 202

Success

The request has been received but not yet acted upon. It may be processed asynchronously.

Tip: Used when processing happens asynchronously or by another service.

Example: POST /api/process starts a batch job and returns 202.
Mock Request Body:
{
"jobType": "report"
}
Try Mock Request:
โ„น๏ธ

Non-Authoritative Information - 203

Success

Returned metadata may not be from the origin server but a local or third-party copy.

Tip: Content is returned from a third-party cache or mirror.

Example: GET /api/backup fetches data from a mirrored server.
Try Mock Request:
๐Ÿ“ญ

No Content - 204

Success

The server successfully processed the request, but there is no content to send in the response.

Tip: Useful for DELETE requests. No body returned but operation succeeded.

Example: DELETE /api/user/5 successfully deletes a user with no response body.
Try Mock Request:
๐Ÿ”„

Reset Content - 205

Success

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

Tip: Used in UIs to signal the client to reset the form or page state.

Example: POST /api/clear-form returns 205 to reset a form UI.
Mock Request Body:
{}
Try Mock Request:
๐Ÿ“ฆ

Partial Content - 206

Success

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

Tip: Common in video streaming and range-based downloads.

Example: GET /api/video.mp4 with range header returns a part of the video.
Try Mock Request:
๐Ÿ“š

Multi-Status - 207

Success

Used in WebDAV to convey status for multiple independent operations.

Tip: Provides status for multiple related operations, used in WebDAV.

Example: PROPFIND /webdav/documents returns multiple file statuses.
Try Mock Request:
๐Ÿ”

Already Reported - 208

Success

Used inside WebDAV <propstat> elements to avoid repeating information about internal bindings.

Tip: Avoids duplication in WebDAV multi-binding responses.

Example: PROPFIND /webdav/shared returns 208 to avoid duplication.
Try Mock Request:
๐Ÿงช

IM Used - 226

Success

Server fulfilled a GET request with a response that represents the result of instance manipulations.

Tip: Used when the response contains transformed content (e.g., delta encoding).

Example: GET /api/data with delta encoding returns transformed data.
Try Mock Request:

Redirection (3xx)

Indicates that further action needs to be taken by the user agent to fulfill the request.

๐Ÿ”€

Multiple Choices - 300

Redirection

The request has more than one possible response. User or user agent should select one of them.

Tip: The client should choose one of the available options. Rarely used in practice.

Example: GET /video returns multiple video format options.
Try Mock Request:
๐Ÿ“Œ

Moved Permanently - 301

Redirection

The URL of the requested resource has been permanently changed.

Tip: Use the new URL in future requests. Search engines update their links to the new one.

Example: GET /old-page redirects to /new-page permanently.
Try Mock Request:
๐Ÿšš

Found - 302

Redirection

The requested resource resides temporarily under a different URI.

Tip: Temporary redirect. Use original URI for future requests.

Example: GET /temporary-redirect redirects to a temporary page.
Try Mock Request:
๐Ÿ”

See Other - 303

Redirection

The response to the request can be found under another URI using a GET method.

Tip: Redirect using GET. Common after form submission or actions.

Example: POST /submit returns a redirect to /status using 303.
Mock Request Body:
{
"task": "upload"
}
Try Mock Request:
๐Ÿ—‚๏ธ

Not Modified - 304

Redirection

Indicates that the resource has not been modified since the last request.

Tip: Used for caching. Saves bandwidth by reusing local cache.

Example: GET /profile with If-Modified-Since header returns 304.
Try Mock Request:
๐Ÿ›ก๏ธ

Use Proxy - 305

Redirection

Defined in a previous specification to indicate that a requested response must be accessed by a proxy. Deprecated due to security concerns.

Tip: Deprecated. Avoid using this code in new applications.

Example: GET /secure-area requires access via proxy.
Try Mock Request:
๐Ÿšซ

Unused - 306

Redirection

This response code is no longer used, but is reserved.

Tip: Reserved for future use. Not actively used today.

Example: GET /legacy-feature returns 306.
Try Mock Request:
๐Ÿ”„

Temporary Redirect - 307

Redirection

Redirects to a different URI, but must use the same HTTP method as the original request.

Tip: Same method is retained (e.g., POST stays POST) in redirection.

Example: POST /submit temporarily redirects to /review.
Mock Request Body:
{
"name": "Sam"
}
Try Mock Request:
๐Ÿ“

Permanent Redirect - 308

Redirection

Similar to 301, but the method and body are preserved across the redirect.

Tip: Use when both the URL and method should be preserved permanently.

Example: POST /upload permanently redirects to /upload-new.
Mock Request Body:
{
"file": "image.jpg"
}
Try Mock Request:

Client Error (4xx)

The client seems to have erred. The request contains bad syntax or cannot be fulfilled.

โŒ

Bad Request - 400

Client Error

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

Tip: Check request syntax and parameters. Ensure all required fields are provided.

Example: POST /api/data with invalid data.
Mock Request Body:
{
"user": ""
}
Try Mock Request:
๐Ÿ”

Unauthorized - 401

Client Error

Client must authenticate to get the requested response. "Unauthorized" means unauthenticated.

Tip: Provide valid authentication credentials.

Example: GET /api/profile without valid token.
Try Mock Request:
๐Ÿ’ฐ

Payment Required - 402

Client Error

Reserved for digital payment systems; rarely used.

Tip: Implement payment workflow if needed.

Example: Access to premium feature requires payment.
Try Mock Request:
๐Ÿšซ

Forbidden - 403

Client Error

Client authenticated but does not have access rights to the content.

Tip: Check user permissions and roles.

Example: GET /admin by non-admin user.
Try Mock Request:
โ“

Not Found - 404

Client Error

Requested resource could not be found on the server.

Tip: Verify the URL or resource existence.

Example: GET /api/unknown-endpoint.
Try Mock Request:
๐Ÿšซ

Method Not Allowed - 405

Client Error

Request method is not supported by the target resource.

Tip: Use allowed HTTP methods only.

Example: DELETE /api/users when DELETE not supported.
Try Mock Request:
โš ๏ธ

Not Acceptable - 406

Client Error

Server cannot produce a response matching the list of acceptable values sent by the client.

Tip: Check Accept headers for supported content types.

Example: Client requests unsupported content-type.
Mock Headers:
{
"Accept": "application/xml"
}
Try Mock Request:
๐Ÿ›ก๏ธ

Proxy Authentication Required - 407

Client Error

Client must authenticate itself with the proxy.

Tip: Authenticate with proxy server.

Example: Access via proxy requires authentication.
Try Mock Request:
โŒ›

Request Timeout - 408

Client Error

Server timed out waiting for the request.

Tip: Retry the request after ensuring connectivity.

Example: Idle connection timed out by server.
Try Mock Request:
โš”๏ธ

Conflict - 409

Client Error

Request conflicts with the current state of the server.

Tip: Resolve conflicts before retrying.

Example: PUT /api/resource when resource has changed.
Try Mock Request:
๐Ÿ—‘๏ธ

Gone - 410

Client Error

Requested resource is permanently deleted and no forwarding address is known.

Tip: Remove cached links to the resource.

Example: GET /api/deprecated-resource.
Try Mock Request:
๐Ÿ“

Length Required - 411

Client Error

Request rejected because Content-Length header is missing.

Tip: Include Content-Length header in request.

Example: POST /api/upload without Content-Length header.
Try Mock Request:
โš ๏ธ

Precondition Failed - 412

Client Error

Precondition given in request headers evaluated to false by server.

Tip: Verify preconditions before sending request.

Example: PUT with If-Match header failed.
Try Mock Request:
๐Ÿ“ฆ

Content Too Large - 413

Client Error

Request entity is larger than limits defined by server.

Tip: Reduce the size of the request payload.

Example: POST /api/upload with a large file.
Try Mock Request:
๐Ÿ”—

URI Too Long - 414

Client Error

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

Tip: Use shorter URIs or POST data for large queries.

Example: GET /api/search?query=<very-long-string>
Try Mock Request:
๐Ÿ“

Unsupported Media Type - 415

Client Error

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

Tip: Check Content-Type header and use supported media types.

Example: POST /api/upload with unsupported media type.
Try Mock Request:
๐Ÿ“

Range Not Satisfiable - 416

Client Error

The range specified in the request cannot be fulfilled.

Tip: Verify Range headers are valid.

Example: GET /api/file with invalid Range header.
Mock Headers:
{
"Range": "bytes=1000-2000"
}
Try Mock Request:
๐Ÿค”

Expectation Failed - 417

Client Error

The expectation given in the Expect request header could not be met by the server.

Tip: Adjust or remove Expect header.

Example: Expect: 100-continue header in request failed.
Mock Headers:
{
"Expect": "100-continue"
}
Try Mock Request:
โ˜•

I'm a teapot - 418

Client Error

The server refuses to brew coffee with a teapot.

Tip: Easter egg status code.

Example: GET /coffee attempted on teapot.
Try Mock Request:
๐Ÿ”€

Misdirected Request - 421

Client Error

Request directed at a server that is not able to produce a response.

Tip: Verify target server.

Example: Request sent to wrong server in multi-server environment.
Try Mock Request:
๐Ÿšซ

Unprocessable Content - 422

Client Error

Request well-formed but semantic errors prevent processing (WebDAV).

Tip: Fix semantic errors in request payload.

Example: PUT /api/resource with semantic errors.
Try Mock Request:
๐Ÿ”’

Locked - 423

Client Error

Resource is locked (WebDAV).

Tip: Retry after lock is released.

Example: PUT /api/resource currently locked by another process.
Try Mock Request:
โ—

Failed Dependency - 424

Client Error

Request failed due to failure of a previous request (WebDAV).

Tip: Resolve previous errors first.

Example: PUT /api/resource failed due to prior error.
Try Mock Request:
โณ

Too Early - 425

Client Error

Server is unwilling to risk processing a request that might be replayed.

Tip: Retry later to avoid replay issues.

Example: Early request before previous processing complete.
Try Mock Request:
โฌ†๏ธ

Upgrade Required - 426

Client Error

Client should switch to a different protocol as requested by server.

Tip: Upgrade client protocol as indicated.

Example: Server requires HTTPS instead of HTTP.
Try Mock Request:
โš ๏ธ

Precondition Required - 428

Client Error

Origin server requires request to be conditional to prevent lost updates.

Tip: Add required precondition headers.

Example: PUT requires If-Match header.
Try Mock Request:
๐Ÿšฆ

Too Many Requests - 429

Client Error

User sent too many requests in a given time (rate limiting).

Tip: Slow down request rate or wait to retry.

Example: Client exceeds API rate limit.
Try Mock Request:
๐Ÿ“ฌ

Request Header Fields Too Large - 431

Client Error

Server refuses to process request because headers are too large.

Tip: Reduce header size and retry.

Example: Request with very large cookies or headers.
Try Mock Request:
โš–๏ธ

Unavailable For Legal Reasons - 451

Client Error

Resource is unavailable due to legal reasons like censorship.

Tip: Check legal access restrictions.

Example: Access blocked by government regulation.
Try Mock Request:

Server Error (5xx)

Indicates that the server failed to fulfill a valid request due to an error on the server side.

๐Ÿ’ฅ

Internal Server Error - 500

Server Error

The server has encountered a situation it does not know how to handle. This error is generic, indicating that the server cannot find a more appropriate 5XX status code to respond with.

Tip: Generic server error. Often indicates a bug or unexpected condition on the server.

Example: A server-side runtime error occurred that prevents fulfilling the request.
Try Mock Request:
๐Ÿ› ๏ธ

Not Implemented - 501

Server Error

The request method is not supported by the server and cannot be handled. The only methods that servers are required to support (and therefore that must not return this code) are GET and HEAD.

Tip: Indicates the server does not support the functionality required to fulfill the request.

Example: Using a PATCH method on a server that only supports GET and POST.
Try Mock Request:
๐Ÿšง

Bad Gateway - 502

Server Error

This error response means that the server, while working as a gateway to get a response needed to handle the request, got an invalid response.

Tip: Common in setups where a proxy or gateway fails to receive a valid response from an upstream server.

Example: A reverse proxy server received an invalid response from an upstream server.
Try Mock Request:
๐Ÿ› ๏ธ

Service Unavailable - 503

Server Error

The server is temporarily unavailable, often due to maintenance or overload. A user-friendly message should accompany this response. The Retry-After header indicates when the service will be available again. Caching should generally be disabled for this response.

Tip: Use Retry-After header to tell clients when to try again.

Example: Server down for maintenance, clients should retry after some time.
Mock Headers:
{
"Retry-After": "120",
"Cache-Control": "no-cache"
}
Try Mock Request:
โฑ๏ธ

Gateway Timeout - 504

Server Error

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

Tip: Timeout between a proxy or gateway and an upstream server.

Example: A gateway or proxy server timed out waiting for a response from an upstream server.
Try Mock Request:
๐Ÿ“ก

HTTP Version Not Supported - 505

Server Error

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

Tip: Server refuses to support the HTTP protocol version used in the request.

Example: Client sends a request with HTTP/1.0 but server only supports HTTP/1.1 or above.
Try Mock Request:
๐Ÿ”„

Variant Also Negotiates - 506

Server Error

The server has an internal configuration error: during content negotiation, the chosen variant is configured to engage in content negotiation itself, causing circular references.

Tip: Rare error caused by server misconfiguration during content negotiation.

Example: Misconfigured server content negotiation causing infinite loops.
Try Mock Request:
๐Ÿ“ฆ

Insufficient Storage (WebDAV) - 507

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.

Tip: Occurs when server storage limits are exceeded.

Example: Server disk space exhausted during a file upload.
Try Mock Request:
๐Ÿ”

Loop Detected (WebDAV) - 508

Server Error

The server detected an infinite loop while processing the request.

Tip: Indicates infinite processing loops detected by the server.

Example: A server-side loop in resource handling, causing request failure.
Try Mock Request:
๐Ÿšซ

Not Extended - 510

Server Error

The client request declares an HTTP Extension that should be used to process the request, but the extension is not supported by the server.

Tip: Used when the server refuses unsupported HTTP extensions.

Example: Client requests features through an unsupported HTTP extension header.
Try Mock Request:
๐Ÿ”

Network Authentication Required - 511

Server Error

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

Tip: Requires network-level authentication before accessing resources.

Example: A captive portal requires login before granting network access.
Try Mock Request: