Custom Integrations - Retrieving Request Results By ID

This API endpoint allows you to retrieve results from previously requested Email Validation, Device Fingerprint and Proxy Detection API endpoints using the request_id from the original request. This allows you to store the request_id from any given API lookup and retrieve the results again at a later date.

Fetching Requests By ID

https://www.ipqualityscore.com/webhooks/ExampleIntegration/json/postback

https://www.ipqualityscore.com/webhooks/ExampleIntegration/html/postback

Request Parameters

Parameter	Description	Example Value / Format
key	Your site's domain or the domain that requested this integration. REQUIRED	google.com
secret	Your user's current secret created during the authentication process. REQUIRED	char(128)
request_id	The Request ID for the original API request. REQUIRED	string

Result

The result from this API should match up to the original request's result and will either be a Email Validation result, Proxy Check result or Device FingerPrint result. For detailed examples of the expected outputs for these result types check out the Email Validation, Device Fingerprint and Proxy Detection respectively. It's generally recommended to use the HTML version when displaying results to administrators in your application and to use the JSON version for additional background processing at a future date. The HTML version will come in a pre-formatted table similar to the screenshot below:

Example Code


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

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

// The original request's ID:
$request_id = '4JAer3sX6vJ3Xk';

// Prepare POST fields.
$fields = array(
	'secret' => $secret,
	'key' => $key,
	'request_id' => $request_id
);
	
// 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){
	echo $result;
} else {
	echo "There appears to be an unforeseen error. Please contact IPQualityScore support if this persists.";
}