Documentation

Quick Start

Validate email addresses in real-time using our REST API. Authenticate with your API key via Authorization: Bearer <key> (or x-api-key header).

curl -X POST http://localhost:3000/v1/validate \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "test@example.com"}'

Response Format

{
  "email": "test@example.com",
  "valid": true,
  "score": 0.95,
  "checks": {
    "syntax": true,
    "mx": true,
    "smtp": true,
    "disposable": false,
    "catchAll": false
  }
}

Endpoints