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/ \
  -H "X-API-Key: YOUR_API_KEY"

Report an IP

Submit an abuse report using a JWT cookie or an API key with the REPORT scope. The response includes a report ID; any eligible credit award is not included in this response.

cURL
curl -X POST https://api.ipabuse.org/v1/ip/report \
  -H "X-API-Key: YOUR_REPORT_SCOPE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ipAddress": "192.168.1.100",
    "categorySlug": "brute-force",
    "description": "Multiple failed SSH login attempts",
    "severity": 3
  }'

Retrieve Reputation Entries

Retrieve reputation entries from the plugin endpoint. Its min_score filter selects entries whose reputation score is at least that value; inspect risk levels and choose your own policy before blocking any IP.

cURL
curl "https://api.ipabuse.org/v1/plugin/blocklist?category=SPAM&min_score=0&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.