MaxMind minFraud Score, minFraud Insights, and minFraud Factors provide a modern RESTful way to access the minFraud data services. This document outlines the major changes for developers when using these services.
For more information about ongoing enhancements to the minFraud services, see our release notes.
The minFraud web services now follow REST principles.
Authentication is done using basic authentication over an SSL connection rather than passing the license key as a query parameter.
All requests are made by a POST of a structured JSON document to the web service.
When an error occurs, we now return an appropriate HTTP error code instead of simply returning a 200 with an error in the document. We also return a JSON document with details about the error in most cases.
Successful responses also return a JSON document. All documents, both successful and error, are in the form of a JSON object.
The following inputs have been added to help us provide you with the most accurate risk assessment possible. Please see the Request API documentation for a complete description.
minFraud Score does not provide any new data outputs. Rather it provides a
simple JSON document containing the
credits_remaining, and any warnings related
to the input provided.
minFraud Insights response data builds on our previous web service outputs, improving organization and consistency while adding several new data points.
Beyond the new outputs listed below, the service provides
GeoIP2 Insights data
for the IP address in the
proxyScore has been replaced with the IP address risk,
Whereas proxyScore ranged from 0-4, the IP address ranges from 0.01 to 99,
ountryMatch has been replaced with
The following outputs have been added.
device(requires Device Tracking Add-on)
* Latitude and longitude are not precise and should not be used to identify a particular street address or household.
The following outputs have been removed without a direct replacement.
minFraud Factors Outputs
In addition to the changes in minFraud Insights, minFraud Factors also included the following outputs:
This page was last updated on October 13, 2021.