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 |