> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.idenfy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fraud Probability

> Calculate fraud probability scores based on multiple risk signals like email, phone, IP, and device data using the iDenfy fraud API.

<Note>
  **Requirements**

  * **API** key pair
  * Fraud probability **credits**
</Note>

***

## Estimate Fraud Probability

<Info>
  **Authorization:** `API key pair`
  **Method:** `POST`
  **Endpoint:** `https://ivs.idenfy.com/fraud/estimate-fraud-probability`
</Info>

<Warning>
  Although none of the parameters below are individually required, the request must contain **at least one** of them.
</Warning>

### Request Parameters

| Key                         | Required | Type   | Constraints             | Explanation                                     |
| --------------------------- | -------- | ------ | ----------------------- | ----------------------------------------------- |
| `user_agent`                | No       | String | Max length 512          | The HTTP `User-Agent` header of the browser     |
| `accept_language`           | No       | String | --                      | The HTTP `Accept-Language` header of the device |
| `ip_address`                | No       | String | `ipv4` or `ipv6` format | User's IP address                               |
| `first_name`                | No       | String | Max length 255          | User's first name                               |
| `last_name`                 | No       | String | Max length 255          | User's last name                                |
| `email_address`             | No       | String | Max length 255          | User's email address                            |
| `email_domain`              | No       | String | Max length 255          | The domain of the `email_address`               |
| `street_address`            | No       | String | Max length 255          | The first line of the user's living address     |
| `city`                      | No       | String | Max length 255          | User's city                                     |
| `country`                   | No       | String | Country alpha-2 code    | User's country                                  |
| `postal_code`               | No       | String | Max length 255          | The postal/zip code of user's living address    |
| `phone_number`              | No       | String | Max length 255          | User's phone number without country code        |
| `phone_country_code`        | No       | String | Max length 4            | User's phone country code (e.g. +370)           |
| `credit_card_number_6`      | No       | String | Length 6                | The first 6 digits of the user's payment card   |
| `credit_card_last_4_digits` | No       | String | Length 4                | The last 4 digits of the user's payment card    |

### Request Example

```json theme={"system"}
{
  "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

```json theme={"system"}
{
  "fraud_level": "LOW"
}
```

### Fraud Levels

| Key           | Type     | Possible Values                                                 |
| ------------- | -------- | --------------------------------------------------------------- |
| `fraud_level` | `String` | `VERY_LOW`, `LOW`, `MEDIUM`, `HIGH`, `VERY_HIGH`, `NOT_CHECKED` |