Skip to content

Device Fingerprint

Registers a device and generates a unique device fingerprint based on the User-Agent, IP, and additional parameters. Returns a device identifier, a risk score, and suspicious-activity flags.

URL

Method: POST

  • Production: https://registry.wallet.kvell.group/reg2/validation/fingerprint

Request parameters

Name Data type Required Description
userAgent string Yes Device User-Agent
ip string No Client IP address
extraData json No Additional browser or device parameters, in JSON format

Request example

{
  "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)",
  "ip": "93.180.71.3",
  "extraData": {
    "screenResolution": "1920x1080"
  }
}

Request headers

Name Data type Required Description
X-Api-Key string Yes Unique identifier (UUID)

Response

Response example

{
  "deviceId": "fp_abc123def456",
  "riskScore": 0.15,
  "flags": []
}

Response parameters

Name Data type Description
deviceId string Unique device identifier
riskScore number Device risk score from 0.0 to 1.0
flags array Suspicious activity flags