Fraud Probability
- API key pair
- Fraud probability credits
Authorization: API key pair
Method: POST
Endpoint: https://ivs.idenfy.com/fraud/estimate-fraud-probability
Despite that none of these parameters are required, but the request must contain at least one of them
user_agent
| Type: String| Required: No
The HTTP User-Agent
header of the browser
Max length 512
accept_language
| Type: String| Required: No
The HTTP Accept-Language
header of the device
—
ip_address
| Type: String| Required: No
User's IP address
ipv4
or ipv6
format
first_name
| Type: String| Required: No
User's first name
Max length 255
last_name
| Type: String| Required: No
User's last name
Max length 255
email_address
| Type: String| Required: No
User's email address
Max length 255
email_domain
| Type: String| Required: No
The domain of the email_address
Max length 255
street_address
| Type: String| Required: No
The first line of the user's living address
Max length 255
city
| Type: String| Required: No
User's city
Max length 255
country
| Type: String| Required: No
User's country
Country alpha-2 code
postal_code
| Type: String| Required: No
The postal/zip code of user's living address
Max length 255
phone_number
| Type: String| Required: No
User's phone number without country code (e.g. without +370, only 640...)
Max length 255
phone_country_code
| Type: String| Required: No
User's phone country code (e.g. +370)
Max length 4
credit_card_number_6
| Type: String| Required: No
The first 6 digits of the user's payment card
Length 6
credit_card_last_4_digits
| Type: String| Required: No
The last 4 digits of the user's payment card
Length 4
Request example
{
"user_agent": "Mozilla/5.0 (Android 7.0; Mobile; rv:54.0) Gecko/54.0 Firefox/54.0",
"accept_language": "en-US,en;q=0.8",
"ip_address": "64.236.213.12",
"first_name": "John",
"last_name": "Smith",
"email_address": "john@gmail.com",
"email_domain": "gmail.com",
"street_address": "123 Address Rd.",
"city": "Boston",
"country": "US",
"postal_code": "34455",
"phone_number": "3439007998",
"phone_country_code": "1",
"credit_card_number_6": "410608",
"credit_card_last_4_digits": "9930"
}
Response example
{
"fraud_level": "LOW"
}
Fraud levels
Key | Type | Constraints |
---|---|---|
fraud_level | String | - Values: - VERY_LOW - LOW - MEDIUM - HIGH - VERY_HIGH - NOT_CHECKED |