IPQS
Getting Started
About the Fraud Reporting API

IPQS allows you to report fraudulent IP addresses, email addresses, phone numbers, transactions, and similar user data through our Fraud Fusion™ program. Data passed through this API endpoint trains your account's machine-learning algorithms, which identify high-risk behavior among your users, clicks, and transactions. Fraud reports are used by our machine learning artificial intelligence engines to make better decisions on risk analysis for future scoring. We recommend using this fraud reporting API to submit all of your existing bad data, such as abusive users and fraudulent e-commerce payments.

Refer to our Terms of Service for information on how this data is used across the IPQS network to improve scoring for all IPQS clients. All data is anonymized and stored using secure protocols.

API Request URLs

You can use the following URLs to submit requests to the Fraud Reporting API using cURL or another utility in most languages.

JSON

XML

Required Parameters

Requests to the Fraud Reporting API must include one of the following parameters:

Field Description Possible Values
ip The IPv4 or IPv6 address to report. IPv4/IPv6 in standard dot/colon notation
email The email address to report. Email Address (string)
request_id The Request ID to report. string
phone The 9 to 20 digit phone number you wish to report. Must include "country" field below. telephone number (number)
country The 2 letter country code (preferred method) or full properly formatted name (capitalization and spacing required) of the country you wish to report. Must include phone field above. country code (string)
Example Requests

Reporting an IP Address


Reporting an Email Address


Reporting a Previous Request


Reporting a Phone Number

Response Examples

Success Responses

This is an example success response in JSON format. Details about each of these variables can be found in Response Parameters.


This is an example success response in XML format. Details about each of these variables can be found in Response Parameters.

 

 


Error Responses

This is an example error response due to insufficient credits.


This is an example error response received when the information has already been reported.

EXAMPLE CODE

Ready to eliminate fraud?

Start fighting fraud now with 5,000 Free Lookups!

We're happy to answer any questions or concerns.

Chat with our fraud detection experts any day of the week.

Call us at: (800) 713-2618