Single Email Validation

Validate an email address in real-time before sending. MailLand runs a 5-layer validation pipeline: syntax check, typo detection, disposable domain detection, role account detection, and SMTP verification.

AuthenticationCopy Anchor Link

Include your API key in the X-API-Key header:

X-API-Key: ml_pv_Ab3Kx9mN2pQ7rT4wL8yD...

The credential must be a Validation product credential with the Api channel enabled.

Validate an EmailCopy Anchor Link

POST https://api.mail.land/v1/validation/email

{
  "email": "[email protected]",
  "verify_smtp": true
}

curl -X POST https://api.mail.land/v1/validation/email \
  -H "X-API-Key: ml_pv_Ab3Kx9mN2pQ7rT4wL8yD..." \
  -H "Content-Type: application/json" \
  -d '{ "email": "[email protected]", "verify_smtp": true }'

ResponseCopy Anchor Link

{
  "email": "[email protected]",
  "result": "Deliverable",
  "score": 95,
  "syntax": {
    "is_valid": true,
    "suggestion": null,
    "domain": "example.com",
    "local_part": "user",
    "has_typo": false,
    "typo_type": null,
    "typo_confidence": null
  },
  "disposable": {
    "is_disposable": false
  },
  "role": {
    "is_role_account": false
  },
  "mx": {
    "has_mx": true,
    "records": ["mx1.example.com", "mx2.example.com"],
    "accepts_mail": true
  },
  "smtp": {
    "can_connect": true,
    "is_deliverable": true,
    "is_catch_all": false,
    "has_full_inbox": false,
    "is_disabled": false,
    "reachability": "safe",
    "error_type": null,
    "error_message": null
  },
  "provider": {
    "name": "Unknown",
    "type": "unknown"
  },
  "cached": false,
  "verified_at": "2026-02-17T12:34:56Z"
}

Result TypesCopy Anchor Link

Score AdjustmentsCopy Anchor Link

The base score is adjusted by risk factors:

Validation PipelineCopy Anchor Link

MailLand validates each email through 5 layers:

Typo DetectionCopy Anchor Link

MailLand uses 3-layer typo detection for common domain mistakes:

When a typo is detected, the syntax.suggestion field contains the corrected address:

{
  "email": "[email protected]",
  "result": "Invalid",
  "score": 5,
  "syntax": {
    "is_valid": true,
    "suggestion": "[email protected]",
    "domain": "gmial.com",
    "local_part": "user",
    "has_typo": true,
    "typo_type": "levenshtein",
    "typo_confidence": 95
  }
}

Provider DetectionCopy Anchor Link

MailLand identifies the email provider from domain names and MX records:

SMTP Check DetailsCopy Anchor Link

The smtp object contains detailed SMTP verification results:

SMTP Error TypesCopy Anchor Link

CreditsCopy Anchor Link

Each validation consumes one credit from your monthly quota. Certain validations are free (no credit consumed):

Check your credit balance:

GET https://api.mail.land/v1/validation/credits

{
  "monthly_quota": 1000,
  "used": 450,
  "remaining": 550,
  "resets_at": "2026-03-01T00:00:00Z"
}

Credits reset automatically on the first day of each month (UTC).

CachingCopy Anchor Link

Validation results are cached in Redis to avoid redundant checks:

Cached responses have cached: true in the response. The original credit was consumed when the result was first computed.

Error ResponsesCopy Anchor Link

Next StepsCopy Anchor Link

• Batch Validation: validate lists of emails in bulk
• Suppressions: manage suppression lists
• REST API: send email to validated addresses