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.

Using the API

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

JSON
https://www.ipqualityscore.com/api/json/report/YOUR_API_KEY_HERE

XML
https://www.ipqualityscore.com/api/xml/report/YOUR_API_KEY_HERE

Required Parameters

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

Example Requests

Reporting an IP Address

https://www.ipqualityscore.com/api/json/report/YOUR_API_KEY_HERE?ip=192.0.2.110

Reporting an Email Address

https://www.ipqualityscore.com/api/json/report/YOUR_API_KEY_HERE?email=noreply@ipqualityscore.com

Reporting a Previous Request

https://www.ipqualityscore.com/api/json/report/YOUR_API_KEY_HERE?request_id=sn342Xd22d

Reporting a Phone Number

https://www.ipqualityscore.com/api/json/report/YOUR_API_KEY_HERE?country=US&phone=8005551234

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.

{
	"success":true,
	"message":"Success",
	"request_id":"3ift1wF"
}

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

<?xml version="1.0" encoding="UTF-8"?>
<result>
	 <request_id>0w8WYS</request_id>        
	 <message>Success</message>
	 <success>true</success>
</result>

Error Responses

This is an example error response due to insufficient credits.

{
	"success":false,
	"message":"You have insufficient credits to make this query. Please contact IPQualityScore support if this error persists.",
	"request_id":"4OTORR352FU0p"
}

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

{
	"success":false,
	"message":"Information reported already exists in our system.",
	"request_id":"4OTORR4EWpl0m"
}