Custom Integrations - Retrieve Device Fingerprint Statistics

<< Back to Categories

Device Tracker Statistics

Fetching Device Fingerprint Statistics in Custom Integrations

This API endpoint allows you to request a list of a user's device trackers by domain, based on the Device Fingerprint service. The results include comprehensive statistics for each device tracker.

Request URL

You can use the following URL to request a list of all device trackers and statistics for each:

Request Parameters

Parameter	Description	Example Value / Format
key	Required. Your site's domain or the domain that requested this integration.	google.com
secret	Required. Your user's current secret created during the authentication process.	char(128)
domain	The domain you wish to fetch trackers for. If none is supplied all device trackers on your account will be returned. If you have a large number of device trackers it's advisable that you supply a domain to reduce query time.	yahoo.com
start	The start date you wish to retrieve statistics from. Must be in Year-Month-Day format.	2025-01-01
stop	The stop date you wish to retrieve statistics from. Must be in Year-Month-Day format. Can not be more than 90 days from start date.	2025-02-01
tracker_name	The tracker name you wish to fetch trackers for. Search will be done case-insensitively, but must be an exact match. If none is supplied all device trackers on your account will be returned. If you have a large number of device trackers it's advisable that you supply a tracker name to reduce query time.	Login Tracker

Response Parameters

Parameter

Description

Format

message

Description of the status of this call. May contain errors if errors exist.

text

success

Boolean result of if the request was successful or not.

boolean

device_trackers

A list of this user's device trackers based on the domain requested.

Array of objects

Parameter	Description	Format
name	A description of the device tracker in question (usually the domain, but can be changed by the user).	text
domain	The domain this tracker was created for.	text, domain
tracker	The API key for this device tracker.	text
usage	A list of statistics for this device tracker. total_requests Total number of device fingerprint requests. (int) high_fraud_risk_requests Total number of device fingerprint requests that were determined to be high risk. (int) recent_abuse_requests Total number of device fingerprint requests that were associated with devices that had recently been involved in abusive or malicious operations. (int) suspicious_requests Total number of device fingerprint requests that were determined to be suspicious. (int)	Array of objects

Example Response

{
    "message": "Success.",
    "success": true,
    "device_trackers": [
        {
            "name": "Octopus",
            "domain": "ipqualityscore.com",
            "tracker": "ft55fastrty232yefhgba",
            "usage": {
                "total_requests": 274094,
                "high_fraud_risk_requests": 224094,
                "recent_abuse_requests": 3094,
                "suspicious_requests": 1102
            }
        }
}

EXAMPLE CODE

// URL for this request.
$URL = 'https://www.ipqualityscore.com/webhooks/ExampleIntegration/json/device_tracker_statistics';

// Configuration items for this request. NOTE: $secret will be user specific not application specific.
$key = 'example.com';
$secret = 'YOUR_API_KEY_HERE';

// Prepare POST fields.
$fields = array(
	'secret' => $secret,
	'key' => $key
);
	
// Create CURL.
$curl = curl_init();
	
// Configure CURL
curl_setopt($curl, CURLOPT_URL, $URL);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($curl, CURLOPT_POST, 1);

// Set POST Parameters
curl_setopt($curl, CURLOPT_POSTFIELDS, http_build_query($fields));

// Fetch URL
$result = curl_exec($curl);

// GET response code.
$response_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);

// Close CURL
curl_close($curl);
	
// Handle result.
if((int) $response_code === 200){
	// JSON Decode
	$output = json_decode($result, true);
	
	// Do something with the response.
} else {
	echo "There appears to be an unforeseen error. Please contact IPQualityScore support if this persists.";
}

Ready to eliminate fraud?

Start fighting fraud now with 1,000 Free Lookups!

We're happy to answer any questions or concerns.

Chat with our fraud detection experts any day of the week.

Call us at: (800) 713-2618

Schedule a Demo Sign Up