A list of global response status codes are listed below to include a description and possible causes:
|
Error Code |
Error Name | Description | Possible Causes | ||
|
400 |
Bad Request | The request could not be understood or was missing required parameters. | Invalid request payload, missing parameters, incorrect data types. | ||
|
401 |
Unauthorized | Authentication failed or user lacks permissions for the requested operation. | Invalid/expired API key/token, incorrect credentials, insufficient privileges. | ||
|
403 |
Forbidden | User is authenticated but does not have access to the resource. | Access restriction, role-based access issue. | ||
|
404 |
Not Found | The requested resource could not be found. | Invalid endpoint URL, non-existent resource ID. | ||
|
405 |
Method Not Allowed | HTTP method is not allowed for the requested resource. | Unsupported method (e.g., POST on a GET-only endpoint). | ||
|
406 |
Not Acceptable | Content not acceptable as per the Accept headers in the request. | Unsupported/invalid Accept header. | ||
|
409 |
Conflict | The request conflicts with the current state of the resource. | Duplicate data entry, conflicting updates, version control issues. | ||
|
415 |
Unsupported Media Type | The request entity has a media type not supported by the server. | Incorrect Content-Type header, unsupported media format. | ||
|
422 |
Unprocessable Entity | The server understands the syntax but can't process the instructions. | Validation errors, business logic conflicts (e.g., invalid date range). | ||
|
429 |
Too Many Requests | User has sent too many requests in a given time (rate limiting). | Rate limit exceeded, burst traffic causing throttling. | ||
|
500 |
Internal Server Error | The server encountered an internal error or misconfiguration. | Server-side issue, database connection problems, unhandled code exceptions. | ||
|
502 |
Bad Gateway | The server received an invalid response from an upstream server. | Issues with third-party services, downstream service unavailability. | ||
|
503 |
Service Unavailable | The server is temporarily unavailable due to overload or maintenance. | Scheduled maintenance, server overload or downtime. | ||
|
504 |
Gateway Timeout | The server didn't receive a timely response from the upstream server. | Timeouts in external systems, long-running processes. | ||