IPAbuse Developers

IP Reputation

The IPAbuse reputation system aggregates community-submitted abuse reports, network intelligence, and automated verification to produce a single reputation score (0–100) for every IPv4 and IPv6 address.

Reputation score

A score of 100 means the IP has never been associated with abuse. A score of 0 means it has been repeatedly and recently verified as malicious.

Score rangeRisk levelRecommended action
80–100LOWAllow — monitor optional
50–79MEDIUMAllow with increased logging
25–49HIGHChallenge (CAPTCHA / 2FA) or block
0–24CRITICALBlock

Public reputation block

Every lookup also returns a reputation block using the public convention: risk_score = 100 - reputationScore, so higher means riskier. The block carries risk_level (low / medium / high / critical), confidence (low / medium / high, derived deterministically from corroboration and freshness) and scoring_version, which identifies the scoring methodology. data_freshness.last_updated is the ISO-8601 time the reputation was last recalculated — treat stale data with caution.

Reputation explanation

GET /v1/ip/{ip}/explanation returns the signals actually contributing to the current classification (reports, corroboration, external intelligence matches) plus explicit limitations. Signals are only listed when the backing evidence exists — the endpoint never speculates, and no AI generation is involved.

Abuse categories

Reports are categorised into the following types:

  • SPAM — unsolicited email or comment spam
  • MALWARE — malware distribution
  • PHISHING — phishing or credential harvesting
  • BRUTE_FORCE — repeated password or login attempts
  • DDoS — denial-of-service activity
  • BOT — malicious bot activity
  • SCANNING — port or vulnerability scanning
  • FRAUD — fraudulent activity
  • OTHER — other abuse categories

Next steps