IPSwamp

There are two main ways to check if an IP is in your honeypot database:

Using the Web Interface

1. Go to the "Check IP" page from the main navigation.
2. Enter the IP address you want to check.
3. Click "Check IP" to see the results.

Using the API

For automated checks, use the API endpoint:

curl -X GET "https://ipswamp.com/api/v1/checkIP?ip=8.8.8.8" \
  -H "X-API-Key: your_api_key_here"

Understanding the Response

The API returns a JSON response indicating whether the IP is a honeypot in your organization, along with details if found.

{
  "message": "IP found!",
  "details": {
    "score": 13.01131,
    "ip": "8.8.8.8",
    "last_attack": "2025-11-29T09:37:40.604584+0000",
    "ip_rep": "bot, crawler",
    "total_hits": 2
  },
  "ipInfo": {
    "ip": "8.8.8.8",
    "asn": "AS15169",
    "as_name": "Google LLC",
    "as_domain": "google.com",
    "country_code": "US",
    "country": "United States",
    "continent_code": "NA",
    "continent": "North America"
  }
}

API keys are essential for programmatic access to IPSwamp. Here's how to manage them:

Creating API Keys

1. Navigate to "Organization" → "API Keys".
2. Click "Generate New API Key" and provide a descriptive name.
3. Copy the key immediately - it's only shown once!

Monitoring Usage

For each API key, you can view:

• Total requests made
• Creation date
• Current usage against your quota

Revoking API Keys

If a key is compromised or no longer needed, click the delete icon to revoke it immediately. This action cannot be undone.

Inviting Team Members

Collaborate with your team by inviting members to your organization:

1. Go to "Organization" → "Members".
2. Click "Invite Member" and enter their email address.
3. They'll receive an invitation email with a link to join.

User Roles

• Administrator: Full access to all organization features, including member management and billing.
• Member: Can view honeypots, check IPs, and use API keys, but cannot modify organization settings.

Organization Settings

Update your organization name, view subscription details, and manage other settings from the organization settings page.

Your API usage is determined by your subscription tier. Here's how to manage it:

Checking Your Quota

View your current usage and limits on the dashboard or by calling the test-key API endpoint.

Upgrading Your Plan

If you need higher limits:

1. Navigate to the "Shop" page.
2. Select a subscription tier that fits your needs.
3. Complete the checkout process.