← Back to Tools

HTTP Status Code Explorer

Search status codes and understand common API responses.

100 Continue

1xx Informational

The server received the initial request headers and is ready for the request body.

Common usage: Large upload begins only after the server confirms it can continue.

101 Switching Protocols

1xx Informational

The server accepts changing to a different protocol requested by the client.

Common usage: HTTP connection upgrades to WebSocket for real-time events.

200 OK

2xx Success

The request succeeded and the server returned the expected response.

Common usage: GET /users/123 returns a user object successfully.

201 Created

2xx Success

A new resource was created as a result of the request.

Common usage: POST /users creates a user and returns its id.

202 Accepted

2xx Success

The request was accepted for processing, but work has not completed yet.

Common usage: Export job is queued and will finish asynchronously.

204 No Content

2xx Success

The request succeeded, but there is no response body to return.

Common usage: DELETE /users/123 succeeds without returning JSON.

301 Moved Permanently

3xx Redirection

The resource has a permanent new URL and clients should update links.

Common usage: Old endpoint permanently redirects to a new versioned endpoint.

302 Found

3xx Redirection

The resource is temporarily available at a different URL.

Common usage: Temporary redirect to a maintenance or login route.

304 Not Modified

3xx Redirection

Cached content is still valid, so the server does not resend the full response.

Common usage: Client sends If-None-Match and keeps existing cached payload.

400 Bad Request

4xx Client Error

The request is malformed or fails validation rules.

Common usage: JSON payload misses required fields or has invalid types.

401 Unauthorized

4xx Client Error

Authentication is required or the provided credentials are invalid.

Common usage: Request is missing a bearer token or token is expired.

403 Forbidden

4xx Client Error

The client is authenticated but does not have permission for this action.

Common usage: Regular user attempts an admin-only operation.

404 Not Found

4xx Client Error

The requested resource could not be found.

Common usage: GET /projects/999 returns no matching project.

405 Method Not Allowed

4xx Client Error

The endpoint exists but does not support the HTTP method used.

Common usage: POST sent to a route that only allows GET.

409 Conflict

4xx Client Error

The request conflicts with the current state of the resource.

Common usage: Attempting to create a user with an email that already exists.

422 Unprocessable Content

4xx Client Error

The request format is valid, but semantic validation failed.

Common usage: Date range is logically invalid even though JSON is valid.

429 Too Many Requests

4xx Client Error

The client exceeded the allowed request rate limit.

Common usage: Too many login attempts in a short time period.

500 Internal Server Error

5xx Server Error

An unexpected server-side error occurred while processing the request.

Common usage: Unhandled exception in the API handler.

501 Not Implemented

5xx Server Error

The server does not support the functionality required for this request.

Common usage: Endpoint exists in docs but is not implemented yet.

502 Bad Gateway

5xx Server Error

A gateway/proxy received an invalid response from an upstream server.

Common usage: API gateway cannot get a valid response from a microservice.

503 Service Unavailable

5xx Server Error

The server is temporarily unable to handle the request.

Common usage: Service is down for maintenance or overloaded.

504 Gateway Timeout

5xx Server Error

A gateway/proxy did not receive a timely response from upstream.

Common usage: Upstream service timed out before responding.

Common choices for mock APIs

200 for success

201 for create

400 for invalid request

401 for missing authentication

403 for no permission

404 for missing resource

429 for rate limit

500 for server error