Documentation

Developer Documentation

Integrate our high-speed validation API or use our open-source library. Block temporary emails with sub-50ms latency.

Quickstart

Get started by calling our public API. For production use, you'll need an API key from your dashboard.

bash

curl -X POST https://api.signguard.co/v1/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "spammer@gmaill.com"}'

Response Schema

Every API response follows a consistent JSON structure. The decision field is your primary indicator.

json

{
  "email": "spammer@gmaill.com",
  "decision": "block",
  "score": 1.0,
  "signals": {
    "disposable_domain": 1.0,
    "typosquatting": 0.0,
    "role_account": 0.0,
    "mx_missing": 0.0
  },
  "reasons": [
    "disposable_domain"
  ]
}

decisionstring

Result: "allow", "review", or "block"

scorenumber

Risk score from 0.0 (safe) to 1.0 (malicious)

signalsobject

Detailed risk values: disposable_domain, typosquatting, role_account, mx_missing

reasonsarray

List of rule identifiers triggered (e.g. ['disposable_domain'])

Python Library

For maximum performance, use our Python library to perform checks locally without any network latency.

Install via pip

bash

pip install disposable-email-score

Usage

python

from disposable_email_score import evaluate_email

# Perform real-time validation
result = evaluate_email("spammer@gmaill.com")

print(f"Decision: {result.decision}")
print(f"Score: {result.score}")