- 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
Deleting Blocklist Entries
Rate this article:
Select all that apply:
Email:
API Request URL
Use the following endpoint to delete blocklisted variables.
https://www.ipqualityscore.com/api/json/blocklist/delete/YOUR_API_KEY_HERE
Request Parameters
This API endpoint has 3 required input parameters.
- value - The value you wish to remove from the blocklist.
- value_type - What kind of value you're removing from the blocklist (e.g., ip, cidr, etc. See below)
- type - What API's blocklist you wish to remove this value from. (One of: proxy, url, email, phone, mobiletracker, devicetracker)
| Accepted Type | Description | Accepted value_types |
|---|---|---|
| proxy | The IP you wish to remove from the blocklist. (e.g., 1.1.1.1) | ip |
| A CIDR (formatted IP/network) you wish to remove from the blocklist. (e.g., 1.1.1.0/24) | cidr | |
| The name of an ISP you wish to remove from the blocklist. | isp | |
| devicetracker | The DeviceID you wish to remove from the blocklist. (e.g., b2q3...) | deviceid |
| The IP you wish to remove from the blocklist. (e.g., 1.1.1.1) | ip | |
| A CIDR (formatted IP/network) you wish to remove from the blocklist. (e.g., 1.1.1.0/24) | cidr | |
| The name of an ISP you wish to remove from the blocklist. (e.g., Spectrum) | isp | |
| mobiletracker | The DeviceID you wish to remove from the blocklist. (e.g., b2q3...) | deviceid |
| The IP you wish to remove from the blocklist. (e.g., 1.1.1.1) | ip | |
| A CIDR (formatted IP/network) you wish to remove from the blocklist. (e.g., 1.1.1.0/24) | cidr | |
| The name of an ISP you wish to remove from the blocklist. (e.g., Spectrum) | isp | |
| The email you wish to remove from the blocklist. (e.g., noreply@ipqualityscore.com) | ||
| url | The domain you wish to remove from the blocklist. (e.g., ipqualityscore.com) | domain |
| phone | The phone number you wish to remove from the blocklist. (e.g., 1-800-713-2618 or 18007132618) | phone |
| custom | The variable you wish to remove from the blocklist. (e.g., 1234) | your_custom_variable (e.g., userID) |
Example Response
This is an example success response in JSON format. Responses are also available in XML format.
{
"success":true,
"message":"Successfully deleted Block List entry.",
"data":[],
"request_id":"CXScW08shC"
}
<?php
/*
* Delete an entry in the Blocklist.
*/
// create post fields
$post = [
'value' => '1.1.1.1',
'value_type' => 'ip',
'type' => 'proxy',
];
// Initialise the cURL var
$ch = curl_init();
// Get the response from cURL
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
// Set type to POST
curl_setopt($ch,CURLOPT_POST, 1);
// Set the POST parameters
curl_setopt($ch, CURLOPT_POSTFIELDS, $post);
// Set the endpoint to request.
curl_setopt($ch, CURLOPT_URL, 'https://ipqualityscore.com/api/json/blocklist/delete/YOUR_API_KEY_HERE');
// Execute the request
$raw_response = curl_exec($ch);
// Decode the response.
$response = json_decode($raw_response, true);
// Print out the result or error.
if($response['success']){
echo "Entry deleted successfully!";
} else {
echo "Failed to delete entry: ".$response['message'];
}