Developer First

API Reference

Integrate high-fidelity intelligence into your applications with our low-latency REST API.

Authentication

Authenticate your requests using a Bearer Token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

Get IP Reputation

GEThttps://api.perceptra.io/v1/ip/{ip_address}

Retrieve reputation data, threat classification, and attribution for a specific IP address.

Example Request

curl -X GET "https://api.perceptra.io/v1/ip/192.168.1.1" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

{
  "ip": "192.168.1.1",
  "score": 85,
  "classification": "malicious",
  "tags": ["scanner", "c2", "mirai"],
  "attribution": {
    "asn": 12345,
    "isp": "BadActor ISP",
    "country": "US"
  },
  "last_seen": "2023-10-27T10:30:00Z"
}

Rate Limits

Standard tier includes 1,000 requests per minute. Enterprise custom limits available.