Skip to main content

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

KeyTypeConstraints
fraud_levelString- Values:
-VERY_LOW
-LOW
-MEDIUM
-HIGH
-VERY_HIGH
-NOT_CHECKED