Migration guide · /api/v2

AbuseIPDB-compatible API

If your tool already speaks AbuseIPDB APIv2, there is no code to rewrite. Change the base URL and the key: same request, same field names, same error format. A way out for servers that keep hitting the daily cap, or simply a second opinion.

Checks / day10,000verified account
Reports / day10,000separate counter
Score basis44threat feeds
PriceFreeno paid plans

Change two things

Find the AbuseIPDB address and key in your tool's settings or script and replace both. The path (/api/v2/…), the parameters and the Key header stay as they are.

WhatBeforeAfter
Base URLhttps://api.abuseipdb.com/api/v2https://ip-db.com/api/v2
Keyyour AbuseIPDB keyyour IP-DB key (ipdb_…)
An AbuseIPDB key is not valid here; an IP-DB key takes a minute from the account panel. Verifying your email lifts the daily limit from 1,000 to 10,000.

Ready-made recipes

Check an address · curl

curl -G https://ip-db.com/api/v2/check \
  --data-urlencode "ipAddress=185.220.101.1" \
  -d maxAgeInDays=90 \
  -H "Key: YOUR_IPDB_KEY" \
  -H "Accept: application/json"

# {"data": {"ipAddress": "185.220.101.1", "isPublic": true, "ipVersion": 4,
#   "isWhitelisted": false, "abuseConfidenceScore": 100, "countryCode": "DE",
#   "usageType": "Data Center/Web Hosting/Transit", "isp": "…", "domain": "…",
#   "hostnames": [], "isTor": true, "totalReports": 0, "numDistinctUsers": 0,
#   "lastReportedAt": null, "ipdb": {"scoreLabel": "critical", "blacklistSources": […], …}}}

Report an address · curl

curl https://ip-db.com/api/v2/report \
  --data-urlencode "ip=203.0.113.7" \
  -d categories=18,22 \
  --data-urlencode "comment=SSH login attempts" \
  -H "Key: YOUR_IPDB_KEY" \
  -H "Accept: application/json"

# {"data": {"ipAddress": "203.0.113.7", "abuseConfidenceScore": 12}}

Python · requests

import requests

r = requests.get(
    "https://ip-db.com/api/v2/check",          # was https://api.abuseipdb.com/api/v2/check
    params={"ipAddress": "185.220.101.1", "maxAgeInDays": 90},
    headers={"Key": "YOUR_IPDB_KEY", "Accept": "application/json"},
    timeout=10,
)
score = r.json()["data"]["abuseConfidenceScore"]

fail2ban: report what it bans

# /etc/fail2ban/action.d/ipdb.conf
[Definition]
norestored = 1
actionstart =
actionstop =
actioncheck =
actionban = curl -sSf "https://ip-db.com/api/v2/report" -H "Accept: application/json" -H "Key: <ipdb_apikey>" --data-urlencode "comment=fail2ban: <name>" --data-urlencode "ip=<ip>" --data "categories=<ipdb_category>"
actionunban =

[Init]
ipdb_apikey =
ipdb_category = 18

# /etc/fail2ban/jail.local
[sshd]
enabled = true
action = %(action_)s
         ipdb[ipdb_apikey="YOUR_IPDB_KEY", ipdb_category="18,22"]

# sudo fail2ban-client reload
Save the file, add it to the jail, reload fail2ban. You do not have to remove your existing AbuseIPDB action; the two run side by side. The comment deliberately carries no log lines: they can contain your hostnames or user names.

What matches exactly

PathsGET /api/v2/check and POST /api/v2/report
ParametersipAddress, maxAgeInDays, verbose; ip, categories, comment
Authenticationthe Key header
Envelope{"data": …} and {"errors": [{detail, status}]}
Field namesabuseConfidenceScore, countryCode, usageType, isp, domain, isTor, totalReports, numDistinctUsers, lastReportedAt…
Status codes401, 422, 429
HeadersX-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, Retry-After
Report categoriesAbuseIPDB's numeric ids (e.g. 18,22) are accepted
The same address can be reported once in 15 minutes

What differs

The format is compatible; the data is not the same data. What to know before you switch:

The score is our scoreabuseConfidenceScore is on the same 0–100 scale but is computed from 44 threat feeds, community reports and DNSBL listings. It will not equal AbuseIPDB's number; watch your threshold (say 75) for a few days and adjust.
maxAgeInDays does not change the answerThe parameter is validated (1–365), but the score always reflects the current listings.
verbose returns no report listcountryName is added; reports is always an empty list. We do not hand out individual reports through the API.
hostnames is emptyReverse DNS is not part of this answer.
Two categories have no counterpart13 (VPN IP) and 17 (Spoofing) do not exist here; a report carrying only those is refused with 422.
Only check and reportblacklist, check-block, bulk-report and clear-address are not offered under /api/v2. For a blocklist, use /api/v1/feed.txt.
Extras live under data.ipdbSource lists, network type, ASN, the RDAP abuse contact and the address's public page. A client written for AbuseIPDB never looks there.

Daily limits

AccountChecks / dayReports / dayPrice
IP-DB, new account1,0001,000Free
IP-DB, email verified10,00010,000Free
IP-DB, contributor (runs a sensor or Shield)30,00030,000Free
AbuseIPDB, free (Individual)1,0001,000Free
The AbuseIPDB row was read off their own pricing and documentation pages on 16 November 2026; check there for the current figure. On IP-DB, checks and reports are counted separately, and /api/v1 and /api/v2 draw on the same counter. The limit resets at local midnight. If you need more, write to us; we raise it at no charge.

Start in a minute

Create an account, verify your email, generate a key in the panel. For every field of our own API and the blocklist feed, see the docs.

Get a free key API docs Integration guides

Frequently Asked Questions

Does my AbuseIPDB key work here?
No. Keys belong to each service; an IP-DB key comes free from the account panel and is sent the same way, in the Key header.
Will the scores match AbuseIPDB's?
No. The scale is the same (0–100) but the calculation is not: the IP-DB score is built from 44 threat feeds, community reports and DNSBL listings. Watch your threshold for a few days and adjust it.
Can I use both at once?
Yes. fail2ban can run more than one action in a jail, and a script can ask both sources. When you hit one service's cap, the other keeps answering.
Does it cost anything?
No. IP-DB is a free, public-interest service with no paid plans. A verified account gets 10,000 checks a day; more is available free on request.
Do /api/v1 and /api/v2 have separate quotas?
No, they share one daily counter. Reports are counted apart from checks, so filing reports never uses up your lookups.

AbuseIPDB is a trademark of its owner. IP-DB is an independent service and is not affiliated with or endorsed by AbuseIPDB.