> ## Documentation Index
> Fetch the complete documentation index at: https://docs.airmdr.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AbuseIPDB

> AbuseIPDB API allows you to integrate AbuseIPDB's data into applications, check the reputation of IP addresses and report abusive IPs. This API is useful for applications that need to prevent malicious activities such as hacking attempts, DDoS attacks, and spam.

### Pre-requisites

<Check>
  User/Admin with an existing Abuse IPDB account, if not

  1. Go to the [AbuseIPDB](https://www.abuseipdb.com/).
  2. In the top right corner, click on **"Sign Up"** to create a new account.
  3. Provide the necessary details (username, email address, password, etc.) and click **"Create Account"**.
  4. **Verify your email** if prompted.

       <Note>
         You will need to confirm your email address by clicking the link in the verification email.
       </Note>
</Check>

### Generate AbuseIPDB API

You will need an API key to interact with the AbuseIPDB.

<Steps>
  <Step title="Access AbuseIPDB Platform">
    1. Login to the [AbuseIPDB](https://www.abuseipdb.com/) as an administrator.
    2. Provide the necessary credentials (**Email** and **Password**), and click **Sign In**.
  </Step>

  <Step title="Generate AbuseIPDB API Key" stepNumber="2">
    1. Select the drop-down list, **User Name** → **Account**.\\
           <img src="https://mintcdn.com/airmdr/sYU3MkOa_oz4znlF/images/AbuseIPDB4.png?fit=max&auto=format&n=sYU3MkOa_oz4znlF&q=85&s=fe4a45e50cade7e40297578d59080c2d" alt="Abuse IPDB4 Pn" width="2360" height="284" data-path="images/AbuseIPDB4.png" />
    2. Go to the **API** tab.
    3. Click **Create Key**.\\
           <img src="https://mintcdn.com/airmdr/sYU3MkOa_oz4znlF/images/AbuseIPDB5.png?fit=max&auto=format&n=sYU3MkOa_oz4znlF&q=85&s=a4a0c9e640977834a9ba2d71c30a80d1" alt="Abuse IPDB5 Pn" width="2254" height="1062" data-path="images/AbuseIPDB5.png" />
    4. Provide unique **Name** to your API Key and click **CREATE**.\\
           <img src="https://mintcdn.com/airmdr/sYU3MkOa_oz4znlF/images/AbuseIPDB6.png?fit=max&auto=format&n=sYU3MkOa_oz4znlF&q=85&s=5476a3245a4fa9ee8fb3407e770355a8" alt="Abuse IPDB6 Pn" width="1168" height="464" data-path="images/AbuseIPDB6.png" />
    5. API Key will be generated, copy and use this key to make API requests.

           <img src="https://mintcdn.com/airmdr/sYU3MkOa_oz4znlF/images/AbuseIPDB7.png?fit=max&auto=format&n=sYU3MkOa_oz4znlF&q=85&s=3e516ade6690ca90e2bf1015ec498b8a" alt="Abuse IPDB7 Pn" width="1166" height="630" data-path="images/AbuseIPDB7.png" />

           <Tip>
             You can View/Copy/Delete all the generated API Keys under Keys section.
           </Tip>

           <Check>
             <Icon icon="envelope" /> Email the **API Key** to AirMDR or self Configure AbuseIPDB in the AirMDR Integrations Dashboard.
           </Check>
  </Step>
</Steps>

### Evaluate AbuseIPDB API Test

Open **cURL** and run the following command to check if your API Access is working:

**Example cURL request:**

```

curl -X GET "https://api.abuseipdb.com/api/v2/check" \
-d ipAddress=8.8.8.8 \
-H "Key: <Your-API-Key>" \
-H "Accept: application/json"
```

<Note>
  Replace `8.8.8.8` with the IP you want to check and `<Your-API-Key>` with your generated API key
</Note>

### Configure AbuseIPDB in the AirMDR Integrations Dashboard

1. Navigate to [AirMDR](https://app.airmdr.com/auth/login), provide the credentials, and click **Login**.\\
   <img src="https://mintcdn.com/airmdr/wnBXbVlE7mmN9W6R/images/Duo7.png?fit=max&auto=format&n=wnBXbVlE7mmN9W6R&q=85&s=eb761cfacb91ef3d08a6f7994022f6d5" alt="Duo7 Pn" width="246" height="381" data-path="images/Duo7.png" />
2. Navigate to the AirMDR Integrations Dashboard in the left navigation pane and select **Integrations**.
3. Use the search option, enter the keyword "**AbuseIPDB**", select the **Connections** tab, and click **Add New Connection**.

   <img src="https://mintcdn.com/airmdr/LHrRdiIMKMojIOnq/images/AbuseIPDB9.png?fit=max&auto=format&n=LHrRdiIMKMojIOnq&q=85&s=ef798ba1e51c7ff3c308dd27e2a8d5c6" alt="Abuse IPDB9 Pn" width="2110" height="1206" data-path="images/AbuseIPDB9.png" />
4. Enter an unique name to the **Instance** (e.g., your org name-AbuseIPDB) and brief **Description** to easily identify the user connection by AirMDR.
5. Enter the generated **API key** and Expiry (optional) in the Authentication Details field params, and click **Save.**

   <img src="https://mintcdn.com/airmdr/LHrRdiIMKMojIOnq/images/AbuseIPDB10.png?fit=max&auto=format&n=LHrRdiIMKMojIOnq&q=85&s=6c9cb06de88ec224f3515d6df39bf4e7" alt="Abuse IPDB10 Pn" width="1502" height="1456" data-path="images/AbuseIPDB10.png" />
