- About the IPQS APIs
- Proxy & VPN Detection API
- Email Verification API
- Phone Number Validation API
- Malicious URL Scanner API
- Device Fingerprint 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
- Allowlist Blocklist APIs
- Plugins Platforms Integrations
- IP Reputation Database
- IP Address Abuse Feed
- Email Verification Database
-
Custom Integrations
- Getting Started
- Authentication
- Refresh Secret
- IP & Proxy Checks
- Email Verification Checks
- Phone Number Validity Checks
- Device Tracker
- List Device Trackers
- Device Tracker Statistics
- Login Tokens
- Overview Statistics
- Recent Proxy Statistics
- Recent Email Statistics
- Fraud Reporting
- Retrieve Requests by ID
- Country List API Documentation
- Release Notes
About Retrieving Requests by ID in Custom Integrations
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.
API Request URLs
JSON
You can use the following URL to retrieve previous requests in JSON format:
https://www.ipqualityscore.com/webhooks/ExampleIntegration/json/postback
HTML
Alternatively, you can use the following URL to retrieve previous requests in HTML format:
https://www.ipqualityscore.com/webhooks/ExampleIntegration/html/postback
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) |
| request_id | Required. The Request ID for the original API request. | string |
Response Parameters
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:
// 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.";
}