Integration with User Scoring via Email and Phone Numbers

To obtain the user’s email and/or phone number score, when creating a user via the API, you must transfer the following to the field

"expected_data": {
  "email": "somebody@example.com",
  "phone": "+15551234567", // international format
  // ...
}

After the user completes the challenge, X-Faces will score the user’s email and phone number, record the result, and send a callback to the partner. The partner can request user data via API:

GET /v1/user/get/<user_uuid>

{
    "email_scoring": {
        "score": 51,
        "riskLevel": {
            "level": "medium",
            "recommendation": "Additional verification"
        }
    },
    "phone_scoring": {
        "score": 0,
        "riskLevel": {
            "level": "low",
            "recommendation": "Allow without checks"
        }
    },
    // ...
}

Risk levels

Level	Score	Recommendation
Low	≤30	Allow without verification
Medium	≤70	Additional verification
High	≤100	Manual blocking
Critical	>100	Automatic blocking