AtData's Fraud Prevention API delivers comprehensive insights into each email address' risk and fraud correlation. Leveraging the extensive data gathered from billions of monthly activity events, our comprehensive historical email database, and a robust fraud consortium database, this API equips you with the detailed information needed to enhance your fraud prevention strategies.
Retrieving Fraud Prevention Data
The Retrieve Fraud Prevention Data is the primary Fraud Prevention API from AtData. It allows you to input a user's email and associated details to retrieve comprehensive information about their fraud risk. This data helps you make informed decisions to protect your system from fraudulent activities.
To use the Retrieve Fraud Prevention Data API, add your API key as a query parameter to the endpoint's URL and the email you want to verify. This is exemplified below:
https://api.atdata.com/fr?api_key=<YOUR_API_KEY>&email=<EMAIL_TO_VERIFY>
Remember to replace <YOUR_API_KEY> with the API key created in Getting Started's Step 2, and <EMAIL_TO_VERIFY>with the actual email you need to verify. The recipe below shows an example code using Python to perform this request:
URL encoding
When integrating with AtData's Fraud Prevention API, ensure that all data added as query parameters are properly encoded using HTML URL encoding. This is essential for the API to function correctly and securely handle your data.
The query parameters for the Retrieve Fraud Prevention Data API are shown in the table below.
| Parameter | Description |
|---|---|
| Required field. The email address that is to be evaluated for fraud. | |
| reference_id | Your internal identifier for the email or the transaction it pertains to. This may be used to cross-reference results with the AtData Feedback API. |
| first | First name. |
| last | Last name. |
| street | The first line of the postal address (including number). |
| city | City of the postal address. |
| state | State of the postal address. |
| zip | ZIP or postcode of the postal address. |
| country | 2-letter country code of postal address following ISO 3166 standard alpha-2 code (e.g., "US," "CA"). |
| phone | Phone number, including country code. |
| ip | User's IP address. |
| user_agent | User agent. |