> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# AbuseIPDB

> AbuseIPDB is a project dedicated to helping make the internet safer by providing a central repository for reporting and checking IP addresses associated with malicious activities.

![AbuseIPDB logo](https://mintcdn.com/composio-preview/qzegrvAapILigeDI/images/toolkits/abuselpdb.svg?fit=max\&auto=format\&n=qzegrvAapILigeDI\&q=85\&s=6239948e3c5eb70f74ade75be4de2c2f)

* **Category:** security & identity tools
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 6
* **Triggers:** 0
* **Slug:** `ABUSELPDB`
* **Version:** 20261101\_00

## Tools

> [accordion] Retrieve IP Blacklist
>
> **Slug:** `ABUSELPDB_BLACKLIST`
>
> Retrieves a list of the most reported malicious IP addresses from AbuseIPDB's database. Use this tool to build dynamic blocklists, threat intelligence feeds, or firewall rules. The blacklist is updated hourly and contains IPs with high abuse confidence scores. Free accounts receive up to 10,000 IPs. Paid subscriptions unlock filtering options (confidenceMinimum, country filters) and higher limits (up to 500,000 IPs).
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum number of IP addresses to return. Free accounts are limited to 10,000 IPs. Paid plans allow up to 100,000 or 500,000 depending on tier.
>
> **ipVersion** `integer ("4" | "6")`
>
> Filter by IP version: 4 for IPv4 addresses only, 6 for IPv6 addresses only. Omit to include both.
>
> **onlyCountries** `string`
>
> Comma-separated ISO 3166-1 alpha-2 country codes to include (e.g., 'US,CA,MX'). Only IPs from these countries are returned. Requires a paid subscription.
>
> **exceptCountries** `string`
>
> Comma-separated ISO 3166-1 alpha-2 country codes to exclude (e.g., 'CN,RU'). IPs from these countries are filtered out. Requires a paid subscription.
>
> **confidenceMinimum** `integer`
>
> Minimum abuse confidence score (25-100) to filter reported IPs. Only IPs with scores at or above this threshold are returned. Requires a paid subscription.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Bulk Report
>
> **Slug:** `ABUSELPDB_BULK_REPORT`
>
> Submit multiple IP abuse reports to AbuseIPDB in bulk via CSV upload. Use this when you need to report many malicious IPs at once instead of one-by-one. Returns the count of successfully saved reports and details about any invalid entries.
>
> #### Input Parameters
>
> **csv** `string` *required*
>
> CSV content containing IP abuse reports. Must include headers: IP, Categories, ReportDate, Comment. IP: Valid IPv4 or IPv6 address. Categories: Comma-separated category IDs (e.g., '18,22' for SSH abuse). Common categories: 3=Fraud Orders, 4=DDoS Attack, 5=FTP Brute-Force, 6=Ping of Death, 7=Phishing, 10=Email Spam, 11=Blog Spam, 14=Port Scan, 18=Brute-Force, 19=Bad Web Bot, 21=Web Spam, 22=SSH, 23=IoT Targeted. ReportDate: ISO 8601 format recommended (e.g., '2024-01-15T10:00:00-05:00'). Comment: Description of the attack (max 1024 characters). Limit: 10,000 rows max, 8MB max file size.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check Block
>
> **Slug:** `ABUSELPDB_CHECK_BLOCK`
>
> Check a CIDR network block for abuse data, including details of reported IP addresses and network information. Available network ranges and report look-back periods depend on the subscription plan.
>
> #### Input Parameters
>
> **network** `string` *required*
>
> IPv4 network in CIDR notation (e.g., '192.168.1.0/24'). Free plans only support /24 networks; paid plans may use wider ranges up to /16.
>
> **maxAgeInDays** `integer`
>
> Number of days back to include abuse reports (1-365). Free plans are limited to 30 days max. Defaults to 30.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Check IP Reputation
>
> **Slug:** `ABUSELPDB_CHECK_IP`
>
> Tool to check the reputation of an IP address. Use when you need to determine if an IP address has been reported for abusive activity within a specified look-back period. Example: CheckIp(ipAddress='8.8.8.8', maxAgeInDays=90).
>
> #### Input Parameters
>
> **verbose** `boolean`
>
> When true, includes detailed abuse reports with comments, categories, and reporter information.
>
> **ipAddress** `string` *required*
>
> IP address (IPv4 or IPv6) to check for abuse reports.
>
> **maxAgeInDays** `integer`
>
> Look-back period for reports in days (default=30, max=365).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Clear Address Reports
>
> **Slug:** `ABUSELPDB_CLEAR_ADDRESS`
>
> Remove reports from your AbuseIPDB account for a specific IP address.
>
> #### Input Parameters
>
> **ipAddress** `string` *required*
>
> A valid IPv4 or IPv6 address whose reports will be removed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Abuse Reports
>
> **Slug:** `ABUSELPDB_GET_REPORTS`
>
> Retrieve paginated abuse reports for a specific IP address from AbuseIPDB, including categories, reporter details, and timestamps. Reports are limited to a look-back period, which defaults to 30 days.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-indexed). Default is 1.
>
> **perPage** `integer`
>
> Number of reports to return per page (1-100). Default is 25.
>
> **ipAddress** `string` *required*
>
> IPv4 or IPv6 address to retrieve reports for
>
> **maxAgeInDays** `integer`
>
> Only return reports from the last N days (1-365). Default is 30 days.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
