Developer Guide

Get User Result

Retrieve an existing transaction from FraudLabs Pro fraud detection system.

Please take note that this API is only available for Medium plan and above. Please upgrade your plan to use it if you are currently subscribed to a lower plan.

Request

GET  https://api.fraudlabspro.com/v2/user/result
Parameter Description
key (required) API license key.
id (required) Unique User Screen ID generated by Screen User API.
format (optional) Return the result in json or xml format. Default:json
Valid values: json | xml

Response

Parameter Description
ip_geolocation.ip IP address of the transaction.
ip_geolocation.continent Estimated continent of the IP address.
ip_geolocation.country_code Estimated ISO-3166 alpha-2 country code of the IP address.
ip_geolocation.country_name Estimated country of the IP address.
ip_geolocation.region Estimated region of the IP address.
ip_geolocation.city Estimated city of the IP address.
ip_geolocation.latitude Estimated latitude of the IP address in 4 precisions.
ip_geolocation.longitude Estimated longitude of the IP address in 4 precisions.
ip_geolocation.zip_code Estimated ZIP code of the IP address.
ip_geolocation.timezone Estimated timezone of the IP address.
ip_geolocation.isp_name Estimated ISP name of the IP address.
ip_geolocation.domain Estimated domain name of the IP address.
ip_geolocation.netspeed Estimated netspeed of the IP address.
ip_geolocation.mobile_mnc Estimated mobile mnc information of the IP address, if it is a mobile network.
ip_geolocation.mobile_mcc Estimated mobile mcc information of the IP address, if it is a mobile network.
ip_geolocation.mobile_brand Estimated mobile brand information of the IP address, if it is a mobile network.
ip_geolocation.elevation Estimated elevation of the IP address.
ip_geolocation.usage_type Estimated usage type of the IP address. Return values as below:
  • Commercial
  • Organization
  • Government
  • Military
  • University/College/School
  • Library
  • Content Delivery Network
  • Fixed Line ISP
  • Mobile ISP
  • Data Center/Web Hosting/Transit
  • Search Engine Spider
ip_geolocation.is_proxy Whether the IP address is from a known anonymous proxy server.
ip_geolocation.is_in_blacklist Whether the IP address is in our blacklist database.
email_address.is_free Whether the email is from free email provider.
email_address.is_disposable Whether the email is a disposable email. Only applicable for Small Plan onward.
email_address.is_domain_exists Whether the email domain name is a valid domain.
email_address.is_new_domain_name Whether the email domain name a newly registered name. Only applicable for non-free email domain.
email_address.is_in_blacklist Whether the email address is in our blacklist database.
phone_number.is_disposable Whether the phone number is a disposable phone number. Only applicable for Medium Plan onward.
phone_number.is_in_blacklist Whether the user's phone number is in our blacklist database.
device.browser The browser name and version.
device.device_type The type of the associated device. (e.g. desktop, mobile)
device.operating_system The operating system name.
device.is_malware_exploit Whether the machine is infected.
device.is_in_blacklist Whether the device Id is in our blacklist database.
user_score Overall score between 1 and 100. 100 is the highest risk and 1 is the lowest risk.
user_transaction_id System own unique identifier to identify this API transaction.
user_transaction_status Final action based on the rules analysis.
Return values: APPROVE | REJECT | REVIEW
user_transaction_rules Return the rules triggered by the system.

Sample Codes

Sample Code
$ curl https://api.fraudlabspro.com/v2/user/result?key=Enter_License_Key&format=json&id=20260131-DEF3CR