Field |
Description |
Type |
message |
Get the response message string for this request. This usually returns "Success" but can include administrator-level information on why a request failed. |
String |
success |
A boolean containing the request's success or failure status. "True" on success, "false" on failure. |
Boolean |
request_id |
The unique ID associated with this request. Helpful for debugging and postbacks. |
String |
fraud_score |
Number 0 - 100 describing how likely this device is to commit fraud. 0 being not at all, 100 being definitively fraudulent. We suggest blocking users greater than 85. |
Float |
country_code |
A two-character country code based on this user's IP address. |
String |
region |
A string describing the region this user's IP is from. |
String |
city |
A string describing the city this user's IP is from. |
String |
ISP |
A string describing the ISP this user's IP belongs to. |
String |
organization |
A string describing the Organization to which this user's IP belongs. |
String |
ASN |
The ASN assigned to the ISP to which this user's IP belongs. |
Integer |
latitude |
The latitude where this user's IP is located. |
Float |
longitude |
The longitude where this user's IP is located. |
Float |
is_crawler |
Returns "true" if this user's IP is from any of the following search engine crawlers: Baidu, Google, Bing, Yahoo, Yandex, Sogou, Exabot, DuckDuckGo, Facebook, Twitter, Pinterest, Naver, UptimeRobot, AppleBot, ArchiveBot, CoccocBot, YisouBot, PetalBot, ByteDance, and MailRU. |
Boolean |
timezone |
Returns the timezone this user's IP is from. |
String |
host |
Returns the hostname of this user's IP address. |
String |
proxy |
Returns "true" if this user's IP is a known proxy. |
Boolean |
vpn |
Returns "true" if this user's IP is a known VPN. |
Boolean |
tor |
Returns "true" if this user's IP is a known or suspected TOR node. |
Boolean |
recent_abuse |
Returns "true" if this user's IP has been reported for being abusive recently or if this device has been seen performing abusive actions. |
Boolean |
bot_status |
Returns "true" if this user's IP has been reported for botting or if this device has been seen performing bot-like actions. |
Boolean |
connection_type |
Classification of the IP address connection type as "Residential", "Corporate", "Education", "Mobile", or "Data Center". |
String |
device_suspicious |
Returns "true" if this device has suspicious properties or has been seen performing suspicious activities recently. |
Boolean |
device_emulated |
Returns "true" if this device has been emulated or appears to have been emulated. |
Boolean |
device_id |
A unique identifier for this device. |
String |