Skip to content

Introduction

Welcome to the IPSwamp API 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

EndpointMethodDescription
/accountGETRetrieve API key and organization quota details
/checkIPGETCheck IP address threat intelligence

Rate Limiting

Usage limits are applied based on your subscription tier:

  • 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.

INFO

The /account endpoint can be used to inspect current quota usage. In the documented response example, it does not count toward quota.

Response Format

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

Common Status Codes

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

Support

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

IPSwamp API Documentation