Getting Started
Making your first API request
Send your first IP lookup and understand the response.
Quick test
The fastest way to test is with curl:
curl -X POST https://predax.io/api/v1/check/ip \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ip": "8.8.8.8"}'Or use the Playground — no code needed.
Understanding the response
{
"ip": "8.8.8.8",
"version": 4,
"classification": {
"risk_score": 15,
"risk_level": "low",
"is_vpn": false,
"is_proxy": false,
"is_tor": false,
"is_datacenter": true,
"is_crawler": false,
"flags": [],
"reasons": []
},
"network": {
"asn": 15169,
"as_name": "Google LLC",
"ptr": "dns.google"
},
"location": {
"country_code": "US",
"country_name": "United States",
"city": "Mountain View"
},
"history": {
"first_seen": null,
"last_seen": null,
"times_seen": null
}
}Key fields
| Field | Description |
|---|---|
classification.risk_score | 0–100. Higher = more suspicious |
classification.risk_level | One of low, medium, high, critical |
classification.is_vpn | True if the IP belongs to a known VPN provider |
classification.is_proxy | True if the IP is a known proxy |
classification.is_tor | True if the IP is a Tor exit node |
classification.is_datacenter | True if the IP belongs to a hosting/cloud provider |
classification.flags | Array of active threat flags |
network.asn / network.as_name | Autonomous System number and operator |
location.country_code | ISO 3166-1 alpha-2 country code |
Next steps
- Full API reference
- Integration guides for your platform
- Best practices for using risk scores