- 400Bad Request
- The request is malformed — invalid JSON, missing required parameters, wrong types.
- 401Unauthorized
- Authentication is missing or invalid. The client should log in or refresh its token.
- 402Payment Required
- Reserved; sometimes used by APIs when a plan limit or payment is required.
- 403Forbidden
- The client is authenticated but not allowed to access this resource.
- 404Not Found
- No resource exists at this URL. Also used to hide resources from unauthorized users.
- 405Method Not Allowed
- The HTTP method isn't supported for this endpoint. Include an Allow header.
- 406Not Acceptable
- The server can't produce a response matching the Accept headers.
- 408Request Timeout
- The client took too long to send the request.
- 409Conflict
- The request conflicts with the current state — duplicate records, edit conflicts, version mismatch.
- 410Gone
- The resource was deliberately removed and won't return. Search engines drop it faster than 404.
- 411Length Required
- The server requires a Content-Length header.
- 412Precondition Failed
- A conditional header (If-Match, If-Unmodified-Since) didn't match — used for optimistic locking.
- 413Content Too Large
- The request body exceeds the server's limit (e.g. Nginx client_max_body_size).
- 414URI Too Long
- The URL is longer than the server will process.
- 415Unsupported Media Type
- The Content-Type isn't supported — e.g. sending form data to a JSON-only endpoint.
- 416Range Not Satisfiable
- The requested byte range is outside the file size.
- 418I'm a teapot
- An April Fools' joke from RFC 2324. Some APIs use it playfully.
- 422Unprocessable Content
- The request is well-formed but fails validation rules — common in REST and Laravel/Rails/FastAPI APIs.
- 423Locked
- The resource is locked (WebDAV).
- 425Too Early
- The server won't process a request that might be replayed (TLS early data).
- 426Upgrade Required
- The client must switch to a different protocol, e.g. TLS or HTTP/2.
- 428Precondition Required
- The server requires conditional requests to prevent lost updates.
- 429Too Many Requests
- Rate limit exceeded. Respect the Retry-After header and back off.
- 431Request Header Fields Too Large
- Headers (often cookies) are too large.
- 451Unavailable For Legal Reasons
- Blocked for legal reasons, such as a court order or regional law.