HTTP Status Codes Reference
Look up HTTP status codes with descriptions, use cases, and examples.
Type a code number or keyword to find status codes
What HTTP Status Code Should I Use?
Success Responses (2xx)
- 200 OK: Request succeeded, response body contains the requested data
- 201 Created: Request succeeded and a new resource was created
- 202 Accepted: Request accepted for processing but not yet complete
- 204 No Content: Request succeeded but there's no content to return
Redirects (3xx)
- 301 Moved Permanently: Resource has moved to a new URL permanently (update bookmarks)
- 302 Found: Resource temporarily moved to a different URL
- 304 Not Modified: Client's cached version is still valid
- 307 Temporary Redirect: Resource temporarily at a different URL (preserves HTTP method)
Client Errors (4xx)
- 400 Bad Request: Malformed request syntax or invalid parameters
- 401 Unauthorized: Authentication required but not provided
- 403 Forbidden: Authenticated but don't have permission to access this resource
- 404 Not Found: Resource doesn't exist on the server
- 429 Too Many Requests: Rate limiting — you're making requests too quickly
Server Errors (5xx)
- 500 Internal Server Error: Server encountered an unexpected condition
- 502 Bad Gateway: Invalid response from upstream server or gateway
- 503 Service Unavailable: Server temporarily can't handle the request (maintenance, overload)
- 504 Gateway Timeout: Upstream server didn't respond in time
HTTP Status Code Categories Explained
1xx — Informational Responses
These codes indicate that the request has been received and the process is continuing. They are interim responses and not final. Common codes: 100 Continue, 101 Switching Protocols.
2xx — Success Responses
These codes indicate that the request was successfully received, understood, and accepted by the server. The most common is 200 OK, indicating the request succeeded and the response contains the requested data.
3xx — Redirection Messages
These codes indicate that further action is needed to complete the request. Common scenarios include resource moved to a new URL (301, 302) or using a cached version (304). The client must follow the redirect.
4xx — Client Error Responses
These codes indicate that the client made an error in the request. Examples include: bad request syntax (400), missing authentication (401), permission denied (403), or resource not found (404). The client should not retry without modification.
5xx — Server Error Responses
These codes indicate that the server failed to fulfill a valid request. Examples include: unexpected server error (500), bad gateway (502), or service temporarily unavailable (503). These are not the client's fault.
Frequently Asked Questions
What's the difference between 301 and 302?
301 (Moved Permanently) means the resource has moved permanently, and all future requests should go to the new URL. Browsers and search engines will update their links. 302 (Found) means the resource is temporarily at a different URL, and future requests should still use the original URL.
What does "401 Unauthorized" vs "403 Forbidden" mean?
401 Unauthorized means the request requires authentication (login), while 403 Forbidden means the request is authenticated but the server refuses to fulfill it due to permissions. In other words: 401 = "who are you?", 403 = "you're not allowed".
Why do I see 404 errors?
A 404 error means the server cannot find the requested resource. Common causes: the URL is incorrect, the page has been deleted, or the resource never existed. Check your URL spelling and try searching the site.
What should I do if I see a 502 or 503 error?
These are server errors, not your fault. Try refreshing the page after a few moments. If the error persists, the website may be experiencing technical difficulties or maintenance. Check their status page or contact their support.
Is my data sent to a server when I search?
No. Everything runs in your browser. Your search queries are never sent anywhere. This reference is completely client-side.
Love using BreezyTools?
Go Pro for an ad-free experience, priority features, and support independent development — for less than a coffee a month.