IPAbuse Developers

Code Examples

Ready-to-run examples for the most common IPAbuse API operations across multiple languages.

IP Reputation Lookup

Check the reputation of any IPv4 or IPv6 address. Uses an API key — safe to call from your backend on every incoming request.

cURL
curl https://api.ipabuse.org/v1/ip/8.8.8.8/reputation \
  -H "X-API-Key: YOUR_API_KEY"

Report an IP

Submit an abuse report on behalf of your account. Requires a JWT token. Successful reports earn credits.

cURL
curl -X POST https://api.ipabuse.org/v1/ip/report \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "ipAddress": "192.168.1.100",
    "category": "SSH_BRUTE_FORCE",
    "description": "Multiple failed SSH login attempts",
    "severity": 3,
    "timestamp": "2025-01-15T08:00:00Z"
  }'

Download a Blocklist

Pull a curated list of abusive IPs filtered by category and risk level. Ideal for firewall deny lists and scheduled cron jobs.

cURL
curl "https://api.ipabuse.org/v1/ip/blocklist?category=SPAM&riskLevel=HIGH&format=json" \
  -H "X-API-Key: YOUR_API_KEY"

Next steps

  • Quickstart — step-by-step first integration.
  • API Reference — full endpoint documentation.
  • SDKs — official libraries that wrap these calls.