Creating Blocklist Entries API Overview

Utilize the Blocklist API to manage your account's blocklisted variables. You may use the following endpoint to create an entry, which overrides the "fraud_score" value to 100 and sets appropriate risk analysis variables as "true". If the API type supports a "valid" or "active" field (such as our email validation or phone validation API endpoints), then these values will always be "false". You can also add a reason why each entry made this list.

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, and 1 optional parameter.

Required:

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)

Optional:

reason - Why did this entry make your block list.

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

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

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

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

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

Accepted Type	Accepted value_types	Description
phone	phone	The phone number you wish to 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 block list. (EG: 1234)

Example Response

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

Example Code

<?php

/*
* Create an entry in the Blocklist.
*/

// create post fields
$post = [
    'value' => '1.1.1.1',
    'value_type' => 'ip',
    'type'   => 'proxy',
    'reason' => 'The reason this entry is on the Blocklist.'
];

// 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/create/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 created successfully!";
} else {
    echo "Failed to create entry: ".$response['message'];
}