Skip to main content

HTTP response codes

Overview of the User.com API​


HTTP response status codes indicate whether a specific HTTP request has been successfully completed. Responses are grouped in five classes: informational responses, successful responses, redirects, client errors, and servers errors.

All error responses are in the following format, delivered with the corresponding status code:

HTTP

Error ResponseDescription
400 Bad RequestThe request was incorrect, please make sure that passed arguments are matching format in method’s documentation.
401 UnauthorizedUnauthorized. You attempt to authenticate with an invalid username or API key.
403 ForbiddenForbidden. Your request is not allowed.
404 Not FoundNot Found. You attempt to request a resource which doesn’t exist.
429 Too Many RequestsToo many requests. You have reached a rate limit.
500 Internal Server ErrorInternal Server Error. Something unexpected happened on our end. Please try again or contact support.
502 Bad GatewayThe server, while acting as a gateway or proxy, received an invalid response from an inbound server it accessed while
504 Gateway TimeoutThe server, while acting as a gateway or proxy, did not receive a timely response from an upstream server it needed to

More on that to be explained here​