Skip to main content
Requirements
  • API key pair
  • Fraud probability credits

​
Estimate Fraud Probability

Authorization: API key pair Method: POST Endpoint: https://ivs.idenfy.com/fraud/estimate-fraud-probability
Although none of the parameters below are individually required, the request must contain at least one of them.

​
Request parameters

KeyRequiredTypeConstraintsExplanation
user_agentNoStringMax length 512The HTTP User-Agent header of the browser
accept_languageNoString—The HTTP Accept-Language header of the device
ip_addressNoStringipv4 or ipv6 formatUser’s IP address
first_nameNoStringMax length 255User’s first name
last_nameNoStringMax length 255User’s last name
email_addressNoStringMax length 255User’s email address
email_domainNoStringMax length 255The domain of the email_address
street_addressNoStringMax length 255The first line of the user’s living address
cityNoStringMax length 255User’s city
countryNoStringCountry alpha-2 codeUser’s country
postal_codeNoStringMax length 255The postal/zip code of user’s living address
phone_numberNoStringMax length 255User’s phone number without country code
phone_country_codeNoStringMax length 4User’s phone country code (e.g. +370)
credit_card_number_6NoStringLength 6The first 6 digits of the user’s payment card
credit_card_last_4_digitsNoStringLength 4The last 4 digits of the user’s payment card

​
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

KeyTypePossible Values
fraud_levelStringVERY_LOW, LOW, MEDIUM, HIGH, VERY_HIGH, NOT_CHECKED