Deleting Blocklist Entries API Overview

Utilize the Blocklist API to manage your account's allowlisted variables. You may use the following endpoint to delete an entry.

Example API URLs

JSON:

NOTE: Do not share this key with anyone. It's like a password and can be used to make queries using our API.

Required GET/POST Parameters:

This API endpoint has 3 required input parameters.

value - The value you wish to block list.
value_type - What kind of value you're block listing (EG: ip, cidr, etc... see below)
type - What API you wish to block list this value for. (One of: proxy, url, email, phone, mobiletracker, devicetracker)

Accepted Type	Accepted value_types	Description
proxy	ip	The IP you wish to remove from the block list. (EG: 1.1.1.1)
	cidr	The CIDR (ip/network) you wish to remove from the block list. (EG: 1.0.0.0/24)
	isp	The ISP you wish to remove from the block list. (EG: Spectrum)

Accepted Type	Accepted value_types	Description
devicetracker	deviceid	The DeviceID you wish to remove from the block list. (EG: b2q3...)
	ip	The IP you wish to delete from the block list. (EG: 1.1.1.1)
	cidr	A CIDR (formatted ip/network) you wish to delete from the block list. (EG: 1.1.1.0/24)
	isp	The name of an ISP you wish to remove from the block list. (EG: Spectrum)

Accepted Type	Accepted value_types	Description
mobiletracker	deviceid	The DeviceID you wish to remove from the block list. (EG: b2q3...)
	ip	The IP you wish to delete from the block list. (EG: 1.1.1.1)
	cidr	A CIDR (formatted ip/network) you wish to delete from the block list. (EG: 1.1.1.0/24)
	isp	The name of an ISP you wish to remove from the block list. (EG: Spectrum)

Accepted Type	Accepted value_types	Description
email	email	The email you wish to remove from the block list. (EG: noreply@ipqualityscore.com)

Accepted Type	Accepted value_types	Description
url	domain	The domain you wish to remove from the block list. (EG: ipqualityscore.com)

Accepted Type	Accepted value_types	Description
phone	phone	The phone number you wish to remove from the block list. (EG: 1-800-713-2618 or 18007132618)

Accepted Type	Accepted value_types	Description
custom	your_custom_variable (EG: userID)	The variable you wish to remove from the block list. (EG: 1234)

Example Response

{
    "success":true,
    "message":"Successfully deleted Block List entry.",
    "data":[],
    "request_id":"CXScW08shC"
}

Example Code

<?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'];
}