Detect Fake Users. Stop Fraud at Signup.

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.