API Errors

RoboWhois uses conventional HTTP response codes to indicate success or failure of an API request. In general, codes in the 2xx range indicate success, codes in the 4xx range indicate an error that resulted from the provided information (e.g. a required parameter was missing, the requested object is not supported, etc.), and codes in the 5xx range indicate an error with RoboWhois’s servers.

All errors return JSON with a code and a name describing the particular problem.

Client Errors

Code Name HTTP Status
C01 Unauthenticated 401
C02 Unauthorized 401
C03 NotFound 404
C04 UsageLimitReached 402

Request Errors

Code Name HTTP Status
R01 ObjectNotSupported 400
R02 WhoisServerNotFound 400
R03 WhoisServerNotAvailable 400
R04 WhoisServerOnlyWeb 400
R05 WhoisServerError 400

Remote or Server Errors

Code Name HTTP Status
S01 RemoteConnectionTimeout 504
S02 RemoteConnectionError 502
S02 RemoteResponseError 502

Application Errors

Code Name HTTP Status
E00 ApplicationError 500
E01 ParserError 500