Bulk Checker Tutorial

The AbuseIPDB Bulk Checker is a powerful feature designed to allow users to check the status of multiple IP addresses at once. Instead of submitting one IP address at a time, this feature lets you upload a file containing hundreds (or even thousands) of IPs, saving time and effort.

Why use the AbuseIPDB Bulk Checker?

  • Speed and efficiency: Upload one file and process hundreds of IPs in a single operation.
  • Check history: Get a complete downloadable report in your preferred format (CSV/XLSX) for a given bulk check.
  • Less Manual Work: Saves time compared to repeated manual checks.

How to configure Your Bulk Check Upload Setting

  1. API key: A valid API key is required. You can use an existing one or generate a new key for free. The most recently created key is selected by default.
  2. Max Age: Enter the number of days (up to 365) for how far back the check should consider IP reports. For example, if you enter 30, the check will only consider reports from the last 30 days.
  3. Remove Duplicates: To avoid redundant checks, check the box to automatically filter duplicate IPs.
  4. Allow Partial Check: If your account is close to exhausting the usage limit, you can enable this option to check only as many IPs as your remaining quota allows.
  5. Click the button to upload the file.
  6. Upon successful upload, you will see a confirmation message.

How to download the results.

After submitting a file for Bulk Check, scroll down to the Bulk Check History section to monitor your task.

Each task goes through three stages:

  • Pending: The bulk check is queued and waiting for processing.
  • Processing: Your IPs are actively being processed.
  • Completed: The bulk check has been completed, and you can download the results.
  • Failed: The bulk check failed due to an internal error. If you see that as a status result, try again and if the problem continues reach out to us for more information.

Once a task reaches the Completed stage:

  1. Choose your preferred format: CSV or XLSX.
  2. Click the button next to the completed task.
  3. Your file will be downloaded to your device containing all check results.

Bulk Checker: Limits Comparison

Features Individual Basic Premium
Available Bulk Checks (per day) 5 100 500
Max amount of ips (per file) 10 100 1000
Remove duplicates

Understanding Your Bulk Check results

Here is a breakdown of the columns you will receive in the result file:

Column Example Value Description
ipAddress 127.0.0.1 The IP address checked.
isPublic Whether the IP is publicly routable.
ipVersion 4 IP version (IPv4 or IPv6).
isWhitelisted Indicates if the IP is marked as whitelisted (e.g., Google DNS).
abuseConfidenceScore Score indicating the likelihood of abuse (0–100).
countryCode DE 2-letter ISO country code.
usageType Reserved Type of usage (e.g., Reserved, Fixed Line ISP, Government).
isp Internet Service Provider name.
domain Associated domain, if any.
hostnames Resolved hostnames for the IP.
isTor True if the IP is part of the Tor network.
totalReports 2 Total number of abuse reports received.
numDistinctUsers 1 Number of distinct users who reported this IP.
lastReportedAt 2025-08-19 21:44:47 Date/time of the most recent abuse report.

Example of Result File (CSV)

        "ipAddress","isPublic","ipVersion","isWhitelisted","abuseConfidenceScore","countryCode","usageType","isp","domain","hostnames","isTor","totalReports","numDistinctUsers","lastReportedAt"
        "127.0.0.1","","4","","","","Reserved","","","","","1662","187","2025-05-07T15:38:53+00:00"
        "123.123.123.213","1","4","","","CN","Fixed Line ISP","China Unicom Beijing province network","chinaunicom.cn","","","","",""
        "45.56.67.78","1","4","","","US","Data Center/Web Hosting/Transit","Linode","linode.com","li917-78.members.linode.com","","","",""
        "1.1.1.1","1","4","1","","AU","Content Delivery Network","APNIC and Cloudflare DNS Resolver project","cloudflare.com","one.one.one.one","","38","11","2025-05-07T12:01:44+00:00"