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.
Search status codes and understand common API responses.
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.
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.
2xx Success
The request succeeded and the server returned the expected response.
Common usage: GET /users/123 returns a user object successfully.
2xx Success
A new resource was created as a result of the request.
Common usage: POST /users creates a user and returns its id.
2xx Success
The request was accepted for processing, but work has not completed yet.
Common usage: Export job is queued and will finish asynchronously.
2xx Success
The request succeeded, but there is no response body to return.
Common usage: DELETE /users/123 succeeds without returning JSON.
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.
3xx Redirection
The resource is temporarily available at a different URL.
Common usage: Temporary redirect to a maintenance or login route.
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.
4xx Client Error
The request is malformed or fails validation rules.
Common usage: JSON payload misses required fields or has invalid types.
4xx Client Error
Authentication is required or the provided credentials are invalid.
Common usage: Request is missing a bearer token or token is expired.
4xx Client Error
The client is authenticated but does not have permission for this action.
Common usage: Regular user attempts an admin-only operation.
4xx Client Error
The requested resource could not be found.
Common usage: GET /projects/999 returns no matching project.
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.
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.
4xx Client Error
The request format is valid, but semantic validation failed.
Common usage: Date range is logically invalid even though JSON is valid.
4xx Client Error
The client exceeded the allowed request rate limit.
Common usage: Too many login attempts in a short time period.
5xx Server Error
An unexpected server-side error occurred while processing the request.
Common usage: Unhandled exception in the API handler.
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.
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.
5xx Server Error
The server is temporarily unable to handle the request.
Common usage: Service is down for maintenance or overloaded.
5xx Server Error
A gateway/proxy did not receive a timely response from upstream.
Common usage: Upstream service timed out before responding.
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