DevicePrint360 API

Real-time device fingerprinting and bot detection API. Identify devices, detect fraud, and assess risk with a single API call.

🚀 Features

Device Fingerprinting - Generate unique, persistent device identifiers
Risk Scoring - Get 0-1 risk scores with LOW, MEDIUM, HIGH, CRITICAL levels
Bot Detection - Identify automated traffic and suspicious behavior
IP Reputation - Real-time IP threat intelligence
Velocity Analysis - Detect unusual request patterns

🔐 Authentication

Authentication is handled automatically by RapidAPI. No additional API keys required - your RapidAPI subscription handles everything.

📡 Endpoints

Health Check

GET /health

Returns API status and version information.

Analyze Fingerprint

POST /fingerprint

Analyze a device fingerprint and get risk assessment.

📋 Request Example

{
  "eventType": "login",
  "ip": "203.0.113.42",
  "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)...",
  "userId": "user_123",
  "timezone": "America/New_York",
  "screen": {
    "width": 1920,
    "height": 1080,
    "pixelRatio": 1
  }
}

📋 Response Example

{
  "success": true,
  "deviceId": "dev_abc123xyz",
  "riskScore": 0.25,
  "riskLevel": "low",
  "signals": {
    "ipReputation": "clean",
    "velocity": "normal",
    "anomalies": [],
    "firstSeenAt": "2026-01-15T00:00:00.000Z",
    "lastSeenAt": "2026-01-30T12:30:00.000Z",
    "eventsCount": 15
  }
}

⚠️ Risk Levels

Level	Score Range	Recommended Action
LOW	0.0 - 0.2	Allow - Trusted device
MEDIUM	0.2 - 0.5	Monitor - Some anomalies detected
HIGH	0.5 - 0.8	Challenge - Request 2FA or CAPTCHA
CRITICAL	0.8 - 1.0	Block - Strong fraud indicators

📌 Event Types

login - User login attempts
signup - New account registration
checkout - Payment/checkout flows
transaction - Financial transactions
password_reset - Password recovery
custom - Custom event types

🔧 Request Parameters

Field	Required	Description
`eventType`	Yes	Type of event being analyzed
`ip`	Yes	Client IP address (IPv4 or IPv6)
`userAgent`	Yes	Browser/client user agent string
`userId`	No	Your internal user identifier
`timezone`	No	Client timezone (e.g., America/New_York)
`screen`	No	Screen dimensions object
`canvasHash`	No	Canvas fingerprint hash
`webglHash`	No	WebGL fingerprint hash

💡 Use Cases

Fraud Prevention - Block suspicious login attempts and fake signups
Account Takeover Protection - Detect unauthorized account access
Bot Detection - Identify and block automated traffic
Multi-Account Prevention - Detect users with multiple accounts
Payment Security - Add risk assessment to checkout flows

📚 Documentation

Full documentation available at: https://deviceprint360.lovable.app/docs

📧 Support

For questions or issues, contact us at: https://deviceprint360.lovable.app/contact