IP Security Lookup
The IP Security API returns detailed threat intelligence for any IPv4 or IPv6 address. It detects VPNs, proxies (including residential), Tor exit nodes, bot or spam activity, and known attacker behavior. It also identifies cloud provider associations and, when available, returns the provider name. In addition, it delivers geolocation and network details enriched with country metadata, making it a comprehensive source of security and geolocation data.
Authorization
You can make authorized requests to our API by passing API key as a query parameter. To get your API key, login to our billing dashboard and get your API key! If your API key has been compromised, you can change it by clicking on reset button in billing dashboard.
Status Codes
Success Codes
- 200 Request is processed successfully.
Failure Codes
- 400 Provided name, service or IP address 'XXX.XXX.XXX.XXX' is not valid.
- 401 Provided API key is invalid.
- 401 Provided API key is inactive.
- 401 Please buy a subscription plan or add api credits, then use this api key.
- 401 Your subscription is deactivated. Please buy new plan or add api credits for using whoisfreaks APIs.
- 401 Your subscription is deactivated due to much time payment failure. Please buy a new plan or add api credits for using whoisfreaks APIs.
- 401 Your account is deactivated.
- 401 You are blocked due to suspicious activity.
- 404 The requested IP does not not exists in our database.
- 405 Invalid HTTP request method is being used for calling the endpoint. Only GET and POST methods are allowed. POST method for bulk endpoint and GET method for single lookup endpoint requests.
- 408 Unable to fetch whois data. Please try again.
- 412 You have exceeded the limit of api plan requests and your subscription is canceled.
- 413 You have exceeded the limit of api credits requests [allowed_request_no]. Please upgrade your plan.
- 413 You have exceeded the limit of Surcharge Requests [allowed_surcharge_request_no]. Please upgrade your plan.
- 423 The IP address you provided falls within bogon IP ranges, which are not routable on the public internet. Please make sure to use a valid, publicly accessible IP address for accurate results.
- 429 Please slow down. Your maximum request limit per minute is reached.
- 499 The request or connection timeout you’ve set is too short, which is causing the server to close the connection before completing the response. Please increase the timeout duration to ensure successful communication with the server.
- 500 Internal Server error occurred.
- 502 Please provide ips in request body.
- 503 Service is unavailable. Please try after some time.
- 504 Request is timed-out.
- 505 You might be using an outdated HTTP version.
