Device Intelligence

Collect and analyze device fingerprints to detect fraud signals — emulators, VPNs, rooted devices, and suspicious device histories. Integrates with VerifyHQ's Risk Manager to enrich identity verification decisions.

POST/intelligence/device/fingerprint

Submit a device fingerprint for analysis. Typically called from your mobile SDK or web client.

Request Body

Parameter	Type	Description
`userId`required	string	Your internal user identifier
`sessionId`required	string	Current session identifier
`fingerprint`required	object	Device fingerprint object collected by the client SDK
`fingerprint.userAgent`	string	Browser or app user agent string
`fingerprint.platform`	string	Operating system platform
`fingerprint.screenResolution`	string	Screen resolution (e.g. 1920x1080)
`fingerprint.timezone`	string	IANA timezone
`fingerprint.language`	string	Browser/device language
`fingerprint.webgl`	string	WebGL renderer hash
`fingerprint.canvas`	string	Canvas fingerprint hash
`ip`	string	Client IP address (auto-detected if not provided)

Code Examples

curl -X POST https://api.verifyhq.com/v1/intelligence/device/fingerprint \
  -H "X-API-Key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": "user_123",
    "sessionId": "sess_abc",
    "fingerprint": {
      "userAgent": "Mozilla/5.0...",
      "platform": "Android",
      "screenResolution": "1080x2400",
      "timezone": "Africa/Lagos",
      "language": "en-NG"
    }
  }'

Response

200 OKjson

{
  "id": "dev_abc123",
  "userId": "user_123",
  "deviceId": "dfp_x7k9m2n4",
  "firstSeen": "2026-01-10T08:00:00Z",
  "riskScore": 0.12,
  "riskLevel": "LOW",
  "signals": {
    "emulator": false,
    "rooted": false,
    "vpn": false,
    "knownFraudDevice": false,
    "multipleAccounts": 1
  },
  "createdAt": "2026-02-18T13:00:00Z"
}

GET/intelligence/device/:id

Retrieve the full assessment for a device fingerprint submission.

curl https://api.verifyhq.com/v1/intelligence/device/dev_abc123 \
  -H "X-API-Key: your_api_key"

Response

200 OKjson

{
  "id": "dev_abc123",
  "userId": "user_123",
  "deviceId": "dfp_x7k9m2n4",
  "riskScore": 0.12,
  "riskLevel": "LOW",
  "signals": {
    "emulator": false,
    "rooted": false,
    "vpn": false,
    "knownFraudDevice": false,
    "multipleAccounts": 1,
    "deviceAge": "39 days",
    "geoMismatch": false
  },
  "location": {
    "country": "NG",
    "city": "Lagos",
    "isp": "MTN Nigeria"
  }
}

Risk Signals

Parameter	Type	Description
`emulator`	boolean	Device is an emulator or virtual machine
`rooted`	boolean	Device is rooted/jailbroken
`vpn`	boolean	Connection through VPN or proxy
`knownFraudDevice`	boolean	Device previously linked to fraud
`multipleAccounts`	number	Number of accounts seen on this device
`geoMismatch`	boolean	Device timezone/location doesn't match IP geolocation