FraudTagger

Integrate FraudTagger into your mobile apps, email-clients, SaaS signup flows and existing website services using a few lines of code.

Quick API Documentation & Code Examples

The API allows you to programmatically check if an email address is likely to be spammy or machine-generated using a simple GET request. Just pass the email and your API key as parameters:

API Endpoint

GET https://api.toridion.com/v1/scoreUsername/?email=joy1@walletx-fakers.net&apikey=YOUR_API_KEY

Parameters

• email (required): The email address to check
• apikey (required): Your API key

Response Format

{
  "metadata": {
    "name": "TQNN Fraud Tagger",
    "endpoint": "/v1/scoreUsername",
    "method": "GET",
    "randomness_range": "0-100",
    "entropy_range": "0-4",
    "confidence_range": "0-100",
    "request_id": "680944f3e3597",
    "timestamp": 1745437939,
    "runtime_seconds": 0.11072802543640137,
    "verbose_mode": "yes",
    "called_by": "Unknown AI system",
    "energy": {
      "energy_usage_kWh": "0.0000052288",
      "carbon_emissions_mg": "1.2183158576",
      "equivalent_meters_driven": "0.0101526321"
    }
  },
  "data": {
    "email": "joy1@walletx-fakers.net",
    "score": 9,
    "score_engine": "V1.0.4",
    "release": "Beta",
    "randomness": "89.66",
    "entropy": "3.59",
    "confidence": "89.83",
    "classification": "SPAM",
    "recommended_action": "quarantine or flag for further investigation",
    "reasoning": {
      "spam_lists_check": "NOT_EVALUATED",
      "similarity_to_known_spam": "Some similarity to known spam",
      "randomness_score": "The randomness is quite high at (89.66) which is unusual for real names and words",
      "entropy_score": "Very High Entropy (3.59)  (Fully Random)"
    }
  }
}

PHP Example

<?php
$email = 'joy1@walletx-fakers.net';
$apikey = 'YOUR_API_KEY';
$url = "https://api.toridion.com/v1/scoreUsername/?email=" . urlencode($email) . "&apikey=" . $apikey;

$response = file_get_contents($url);
$data = json_decode($response, true);

echo "Classification: " . $data['data']['classification'];
?>

Python Example

import requests

email = "joy1@walletx-fakers.net"
apikey = "YOUR_API_KEY"
url = "https://api.toridion.com/v1/scoreUsername/?email={email}&apikey={apikey}"

response = requests.get(url)
data = response.json()

print("Classification:", data["data"]["classification"])

Notes

• You can perform up to 10 checks per day for free on the demo version.
• Upgrade to a paid plan for more usage, API keys, and premium support.
• Real-time responses are typically under 300ms.
• FraudTagger is a AI driven email address and username evaluation engine powered by Toridion TQNN. In controlled tests FraudTagger was able to identify approximately 84% of fake or machine generated Email usernames however Toridion cannot guarantee that any email address may be correctly identified as machine or human generated due to the complex nature of the subject. For further reading please read the published study on research gate here