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".

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 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
Example Code