ValidationResult

emailstring

statusstring

• valid — Email valide et délivrable
• invalid — Email invalide (syntaxe, domaine inexistant, SMTP rejeté)
• risky — Email risqué (jetable, role account, aléatoire)
• unknown — Impossible de vérifier (timeout SMTP, greylisting)

Possible values: [valid, invalid, risky, unknown]

scoreinteger

Score de qualité (0 = invalide, 100 = parfait)

Possible values: >= 0 and <= 100

syntax object

validboolean

normalizedstring

Example: [email protected]

localPartstring

Example: john.doe

domainstring

Example: gmail.com

dns object

hasMxRecordsboolean

mxRecordsstring[]

Example: ["gmail-smtp-in.l.google.com"]

hasARecordboolean

disposable object

isDisposableboolean

providerstringnullable

Example: 10minutemail.com

roleAccount object

isRoleAccountboolean

reasonstringnullable

Example: Generic prefix: info

typo object

hasTypoboolean

suggestionsstring[]

Example: ["[email protected]"]

randomDetection object

isRandomboolean

confidencenumber<float>

Example: 0.05

smtp object

performedboolean

deliverablebooleannullable

responseCodeintegernullable

Example: 250

responseMessagestringnullable

Example: OK

greylistedDetectedbooleannullable

catchAllDetectedbooleannullable

enrichment objectnullable

guessedFirstnamestringnullable

Example: John

genderConfidencenumbernullable

metadata object

creditsUsedinteger

Example: 1

creditsRemaininginteger

Example: 499

processingTimeMsinteger

Example: 2341

smtpEnabledboolean

apiVersionstring

Example: v2

ValidationResult

{
  "email": "string",
  "status": "valid",
  "score": 0,
  "syntax": {
    "valid": true,
    "normalized": "[email protected]",
    "localPart": "john.doe",
    "domain": "gmail.com"
  },
  "dns": {
    "hasMxRecords": true,
    "mxRecords": [
      "gmail-smtp-in.l.google.com"
    ],
    "hasARecord": true
  },
  "disposable": {
    "isDisposable": true,
    "provider": "10minutemail.com"
  },
  "roleAccount": {
    "isRoleAccount": true,
    "reason": "Generic prefix: info"
  },
  "typo": {
    "hasTypo": true,
    "suggestions": [
      "[email protected]"
    ]
  },
  "randomDetection": {
    "isRandom": true,
    "confidence": 0.05
  },
  "smtp": {
    "performed": true,
    "deliverable": true,
    "responseCode": 250,
    "responseMessage": "OK",
    "greylistedDetected": true,
    "catchAllDetected": true
  },
  "enrichment": {
    "guessedFirstname": "John",
    "genderConfidence": 0
  },
  "metadata": {
    "creditsUsed": 1,
    "creditsRemaining": 499,
    "processingTimeMs": 2341,
    "smtpEnabled": true,
    "apiVersion": "v2"
  }
}