IPAbuse Developers
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