HTTP status code and its meaning
HTTP Status Codes Reference
Common Client Error Codes (4xx)
| Status Code | Explanation |
|---|---|
| 400 Bad Request | The request format is incorrect or cannot be understood by the server. Usually means client error. |
| 401 Unauthorized | API key verification failed. You need to verify that your API key is correct. Other reasons include token expiration. |
| 403 Forbidden | Insufficient permissions to access the resource. |
| 404 Not Found | The requested resource was not found. You may be trying to access an endpoint that does not exist. |
| 408 Request Timeout | The server timed out waiting for the request. The client may try again. |
| 413 Request Entity Too Large | The request body is too large. You may need to reduce your request size. |
| 429 Too Many Requests | You have exceeded your rate limit due to frequent requests exceeding the limit. |
Common Server Error Codes (5xx)
| Status Code | Explanation |
|---|---|
| 500 Internal Server Error | Error inside the server. This may be an OpenAI server problem, not yours. |
| 502 Bad Gateway | The server, while acting as a gateway or proxy, received an invalid response from the upstream server. |
| 503 Service Unavailable | The server is temporarily unavailable. This may be due to maintenance or overload. |
| 504 Gateway Timeout | The server, while acting as a gateway or proxy, did not receive a timely response from the upstream server. |
Common Success Codes (2xx)
| Status Code | Explanation |
|---|---|
| 200 OK | The request has succeeded. Standard response for successful HTTP requests. |
| 201 Created | The request has been fulfilled, and a new resource has been created as a result. Often used with POST requests. |
| 202 Accepted | The request has been accepted for processing, but processing has not been completed yet. |
| 204 No Content | The server successfully processed the request, but there is no content to return. |
Common Redirection Codes (3xx)
| Status Code | Explanation |
|---|---|
| 301 Moved Permanently | The requested resource has been permanently moved to a new URL. Clients should use the new URL. |
| 302 Found | The requested resource resides temporarily under a different URL. Commonly used for redirection. |
| 304 Not Modified | Indicates that the resource has not been modified since the last request. Typically used with caching. |
⚠️ Note: This list covers only common HTTP status codes. More exist across the 1xx (informational), 2xx (success), 3xx (redirection), 4xx (client errors), and 5xx (server errors) ranges. Behavior may vary depending on server and API implementation.
Modified at 2025-09-19 02:26:37