Help Center/API & Integration/Bulk IP lookups

API & Integration

Bulk IP lookups

Look up multiple IPs in a single request.


Bulk lookup endpoint

Submit up to 100 IPs in a single request:

curl -X POST https://predax.io/api/v1/check/ip/bulk \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ips": ["8.8.8.8", "1.1.1.1", "203.0.113.5"]}'

Response format

Returns an array of results, one per IP, each with the same shape as the single-IP endpoint:

{
  "results": [
    { "ip": "8.8.8.8", "classification": { "risk_score": 15, ... }, "network": { ... }, "location": { ... } },
    { "ip": "1.1.1.1", "classification": { "risk_score": 10, ... }, "network": { ... }, "location": { ... } },
    { "ip": "203.0.113.5", "classification": { "risk_score": 72, ... }, "network": { ... }, "location": { ... } }
  ]
}

When to use bulk

  • Processing server access logs
  • Screening a batch of orders
  • Importing IP lists for threat analysis
  • Running periodic checks on active sessions

Use Dashboard → Bulk Jobs for uploading CSV files of IPs through the web interface.

Limits

  • Max 100 IPs per request
  • Each IP counts as one lookup against your monthly quota
  • Same per-second rate limits apply

See the API Reference for full details.