API Error Reference

HTTP Error Codes

Code Message Meaning Typical Fix
400 Bad Request The request could not be understood by the server due to malformed syntax. Check request parameters and JSON formatting.
401 Unauthorized Authentication is required and has failed or not been provided. Provide a valid API token or credentials.
403 Forbidden The server understood the request, but refuses to authorize it. Ensure your account has permission for the resource.
404 Not Found The requested resource could not be found. Verify the endpoint URL and resource identifier.
405 Method Not Allowed HTTP method is not supported for the requested resource. Use a supported method (GET, POST, PUT, DELETE).
408 Request Timeout The server timed out waiting for the request. Retry the request; consider increasing timeout.
429 Too Many Requests Rate limit exceeded. Implement exponential backoff and respect Retry-After header.
500 Internal Server Error Unexpected condition prevented the server from fulfilling the request. Check server logs; contact support if persistent.
502 Bad Gateway Invalid response from an upstream server. Verify upstream services; retry later.
503 Service Unavailable Server is currently unable to handle the request due to overload or maintenance. Retry after some time; monitor service status.
504 Gateway Timeout Upstream server failed to send a request in time. Check network latency; retry later.