HTTP status codes quick reference
The status codes you most often see from APIs and CDNs, from 200 OK to 504 Gateway Timeout. Rare experimental codes are left out.
| Code | Name | Meaning |
|---|---|---|
| 200 | OK | Success with body |
| 201 | Created | Resource created |
| 204 | No Content | Success, empty body |
| 301 | Moved Permanently | Permanent redirect |
| 302 | Found | Temporary redirect |
| 304 | Not Modified | Use cached copy |
| 400 | Bad Request | Client request invalid |
| 401 | Unauthorized | Auth required / failed |
| 403 | Forbidden | Authenticated but denied |
| 404 | Not Found | No such resource |
| 405 | Method Not Allowed | Wrong HTTP method |
| 408 | Request Timeout | Client too slow |
| 409 | Conflict | State conflict |
| 410 | Gone | Permanently removed |
| 422 | Unprocessable Entity | Semantics invalid |
| 429 | Too Many Requests | Rate limited |
| 500 | Internal Server Error | Server fault |
| 502 | Bad Gateway | Upstream invalid |
| 503 | Service Unavailable | Overloaded / down |
| 504 | Gateway Timeout | Upstream timeout |
Notes
- 401 vs 403: missing or failed credentials versus signed in but not allowed.
- A CDN may return 5xx when the origin server cannot be reached.
Frequently asked questions
- What does HTTP 403 mean?
- 403 Forbidden means the server understood and authenticated the request but refuses to grant access to the resource. Unlike 401, logging in again will not help.
- What is the difference between HTTP 301 and 302 redirects?
- 301 means the resource has moved permanently, so clients and search engines should use the new URL from now on. 302 is a temporary redirect and the original URL remains valid.
- What does HTTP 429 mean and how do I fix it?
- 429 Too Many Requests means you have hit a rate limit. Slow down your requests and honor the Retry-After header if the server provides one.