API v1 Overview

Welcome to the IPSwamp User API (v1) documentation. This API provides threat intelligence and IP reputation services.

Base URL

https://ipswamp.com/api/v1

Quick Start

1. Obtain an API Key from your IPSwamp dashboard
2. Authenticate your requests using Bearer token or API key header
3. Make requests to the available endpoints

Available Endpoints

Endpoint	Method	Description
/checkIP	GET	Check IP address threat intelligence
/test-key	GET	Validate API key and check usage

Authentication Methods

All API v1 endpoints require authentication. See the Authentication page for details.

Rate Limiting

Usage limits are applied based on your subscription tier:

• Check current usage via the test-key endpoint
• Usage resets according to your billing cycle
• Priority: Partner Status > Active Subscription > Unlimited

WARNING

Each successful API call (2xx) or client error (4xx, except 404) increments your usage counter.

Response Format

All responses are returned in JSON format with appropriate HTTP status codes.

Common Status Codes

Status	Meaning
200	Success
400	Bad Request - Invalid parameters
401	Unauthorized - API key required
403	Forbidden - Invalid or expired API key
500	Internal Server Error

Support

For API support and questions, please contact our support team or visit the IPSwamp dashboard.