Beginner8 min
Reporting Abusive IPs
Submit an IP abuse report with a valid category slug and review the report confirmation and your account credits.
1
Authenticate
You can submit a report with a JWT cookie or an API key with the REPORT scope. This example saves a login cookie for the balance check.
cURL
curl -c cookies.txt -X POST https://api.ipabuse.org/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"you@example.com","password":"••••••"}'2
Choose an abuse category
Use a category slug from GET /v1/categories, such as spam, brute-force, port-scan, phishing, malware, ddos, or sql-injection.
3
Submit the report
POST the report with an IP address, category slug, short description, and integer severity from 1 to 10.
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": "1.2.3.4",
"categorySlug": "spam",
"description": "Sending spam emails from this IP",
"severity": 3
}'4
Check your credit balance
Check your account balance separately; the report response only includes a report ID.
cURL
curl -b cookies.txt https://api.ipabuse.org/v1/credits/balance