Fraud Probability

Requirements

• API key pair
• Fraud probability credits

---

fraud probability check

Authorization: API key pair
Method: POST
Endpoint: https://ivs.idenfy.com/fraud/estimate-fraud-probability

required parameters

Despite that none of these parameters are required, but the request must contain at least one of them

user_agent| Type: String| Required: No

Explanation:

The HTTP User-Agent header of the browser

Constraints:

Max length 512

accept_language| Type: String| Required: No

Explanation:

The HTTP Accept-Language header of the device

Constraints:

—

ip_address| Type: String| Required: No

Explanation:

User's IP address

Constraints:

ipv4 or ipv6 format

first_name| Type: String| Required: No

Explanation:

User's first name

Constraints:

Max length 255

last_name| Type: String| Required: No

Explanation:

User's last name

Constraints:

Max length 255

email_address| Type: String| Required: No

Explanation:

User's email address

Constraints:

Max length 255

email_domain| Type: String| Required: No

Explanation:

The domain of the email_address

Constraints:

Max length 255

street_address| Type: String| Required: No

Explanation:

The first line of the user's living address

Constraints:

Max length 255

city| Type: String| Required: No

Explanation:

User's city

Constraints:

Max length 255

country| Type: String| Required: No

Explanation:

User's country

Constraints:

Country alpha-2 code

postal_code| Type: String| Required: No

Explanation:

The postal/zip code of user's living address

Constraints:

Max length 255

phone_number| Type: String| Required: No

Explanation:

User's phone number without country code (e.g. without +370, only 640...)

Constraints:

Max length 255

phone_country_code| Type: String| Required: No

Explanation:

User's phone country code (e.g. +370)

Constraints:

Max length 4

credit_card_number_6| Type: String| Required: No

Explanation:

The first 6 digits of the user's payment card

Constraints:

Length 6

credit_card_last_4_digits| Type: String| Required: No

Explanation:

The last 4 digits of the user's payment card

Constraints:

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