This API endpoint allows you to retrieve results from previously requested Email Verification, Device Fingerprint, and Proxy Detection API endpoints using the request_id from the original request. Doing so will enable you to store the request_id from any given API lookup and retrieve the results again later. It supports both JSON and HTML (table) responses, allowing you to choose how to display results.
- Proxy & VPN Detection API
- Email Verification API
- Phone Number Validation API
- Device Fingerprint API
- Malicious URL Scanner API
- Mobile Device Fingerprinting SDK
- Gaming Fraud Detection SDK
- Dark Web Leak API
- Malware File Scanner API
- Request List API
- Fraud Reporting API
- Account Management APIs
- Bulk Validation CSV API
- Allowlist & Blocklist APIs
- Plugins Platforms & Integrations
- IP Reputation Database
- Email Verification Database
- Custom Integrations
- Country List API
JSON
You can use the following URL to retrieve previous requests in JSON format:
HTML
Alternatively, you can use the following URL to retrieve previous requests in HTML format:
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) |
request_id | Required. The Request ID for the original API request. | string |
The result from this API should match the original request's result. It will either be an Email Verification result, Proxy Check result, or Device FingerPrint result. For detailed examples of the expected outputs for these result types, see Email Verification, Device Fingerprint, and Proxy Detection. We recommend the HTML version when displaying results to administrators in your application and using 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:
xxxxxxxxxx
// 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 = 'YOUR_API_KEY_HERE';
// 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.";
}