How can we help?

Ask a question or search our knowledge base:

 

 

Using the Device Fingerprinting APIs

Once you've installed the JavaScript snippet as shown in our API doc, you can begin making calls to the Device Fingerprinting API. The doc also shows calls and sample responses.

Tips:

  • The JavaScript API key you use in the JavaScript snippet, the account id, and REST API key you use when making calls all need to match up. Make sure to use all Sandbox or all Production values.
  • You can make the following calls on the session id and user id (if relevant) you find in the page source when you visit your website yourself as a test run. Try this first with all SandBox values as described above. 

When a user takes an action you want to protect

When a user takes an action you want to prevent fraudulent devices from taking, such as signing up for a new account, you can make a call to get the device information in exchange for the session id. These calls will show up in 'Session ID API Activity' of your console's developer page and in the 'Session ID' log.

GET /v3/accounts/{accountId}/sessions/{sessionId}

Checking for new information about a device

If you store a device's id, you can make a call to get information about that device at any time. These calls will show up in the 'Device Fingerprint API Activity' section of your console's developer page and in the 'Device Fingerprinting' log.

GET /v3/accounts/{accountId}/devices/{deviceId} 

When a user commits fraud

When a user commits fraud, label the device as bad. These calls will show up in the 'Device Label API Activity' section of your console's developer page and in the 'Device Label' log.

PUT /v3/accounts/{accountId}/devices/{deviceId}/label

Note: You can both label and un-label a device as 'bad' or 'not_bad' in order to maintain both a blacklist and a whitelist! See here for more details. 

When you want to get all the devices for a user

If you're setting a user_id value in the JavaScript snippet, you can ask for a list of devices associated with the user. These calls will show up in the 'User Devices' log.

GET /v3/accounts/{accountId}/users/{userId}/devices

 

 

 

 

Have more questions? Submit a request