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.