ValidMail Documentation

Learn how to integrate ValidMail's email verification API into your applications. Our API provides 99%+ accuracy email validation with real-time results.

Quick Start

Get started with email verification in under 5 minutes.

Get started

API Reference

Complete API documentation with all endpoints and parameters.

View API

Code Examples

Ready-to-use examples in Python, Node.js, PHP, and more.

View examples

What ValidMail Checks

Our comprehensive verification process includes multiple validation layers to ensure the highest accuracy.

Syntax Validation

Validates email format against RFC 5322 standards, checks for valid characters and structure.

DNS & MX Records

Verifies the domain exists and has valid mail exchange records configured.

SMTP Verification

Connects to the mail server to verify the mailbox exists without sending an email.

Disposable Email Detection

Identifies temporary and disposable email addresses from 120,000+ known providers.

Role-Based Detection

Flags generic role-based addresses like info@, support@, admin@.

Spam Trap Detection

Identifies known spam trap patterns to protect your sender reputation.

Catch-All Detection

Detects domains configured to accept all emails regardless of recipient.

Domain Reputation

Checks domain against DNS blacklists and reputation databases.

Social Proof Verification

Verifies email existence through social platform presence (Gravatar, etc.).

API Response Example

Here's what a typical verification response looks like:

{
  "email": "john@example.com",
  "status": "valid",
  "score": 95,
  "verdict": "Email verified with high confidence",
  "checks": {
    "syntax": { "valid": true },
    "dns": { "valid": true, "hasMx": true },
    "smtp": { "valid": true, "catchAll": false },
    "disposable": false,
    "roleBased": false,
    "freeProvider": false,
    "spamTrap": false
  },
  "meta": {
    "responseTime": 1234
  }
}

Understanding Verification Status

Status	Description	Recommendation
valid	Email exists and can receive messages	Safe to send
invalid	Email does not exist or cannot receive messages	Remove from list
risky	Email may be valid but has risk factors	Send with caution
unknown	Could not determine validity	Manual review recommended

Next Steps

Ready to start verifying emails? Here's what to do next:

1Create an account to get your API key
2Follow the Quick Start guide to make your first API call
3Explore the API Reference for advanced features