API Reference

API Documentation

Complete reference for all FraudShield AI APIs

API Key AuthREST APITLS 1.3
POST/api/v1/ip/reputation

Analyze an IP address for fraud risk, VPN/proxy detection, and threat intelligence.

Parameters

iprequired
stringIPv4 or IPv6 address to check
strictness
integerDetection strictness (0-3, default 1)
allow_public_access_points
booleanAllow public hotspots

Code Examples

curl
curl -X POST "https://api.fraudshield.ai/v1/ip/reputation" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"ip": "185.220.101.34"}'

Response

200 OK · application/json
{
  "success": true,
  "ip": "185.220.101.34",
  "fraud_score": 87,
  "risk_level": "high",
  "country_code": "DE",
  "city": "Frankfurt",
  "ISP": "Hetzner Online GmbH",
  "ASN": 24940,
  "vpn": true,
  "proxy": false,
  "tor": true,
  "active_vpn": true,
  "datacenter": true,
  "abuse_velocity": "high",
  "bot_status": false,
  "recent_abuse": true,
  "threat_type": "tor_exit_node"
}

Rate Limiting

Free
10 req/min
Starter
100 req/min
Business
1,000 req/min

Rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset