Email Validation

Single Email Verification

Verify a single email address in real-time via the REST API. Useful for signup forms, CRM integrations, or one-off checks.

Endpoint

text

POST /v1/verify

Request

bash

curl -X POST http://YOUR_SERVER/v1/verify \
  -H "Content-Type: application/json" \
  -H "Cookie: auth_token=YOUR_SESSION" \
  -d '{"email": "john@example.com", "level": 2}'

Parameters

Field	Type	Required	Description
`email`	string	Yes	Email address to verify
`level`	integer	No	1 = fast checks only, 2 = full SMTP handshake (default: 1)

Response

json

{
  "email": "john@example.com",
  "reachable": "yes",
  "syntax": {
    "username": "john",
    "domain": "example.com",
    "valid": true
  },
  "smtp": {
    "host_exists": true,
    "full_inbox": false,
    "catch_all": false,
    "deliverable": true,
    "disabled": false
  },
  "suggestion": "",
  "disposable": false,
  "role_account": false,
  "free": false,
  "has_mx_records": true
}

Response Fields

Field	Description
`reachable`	`yes` / `no` / `unknown`
`syntax.valid`	Whether the email passes RFC syntax check
`smtp.deliverable`	Whether the SMTP server accepted the RCPT TO command
`smtp.catch_all`	Whether the domain accepts all addresses
`disposable`	Whether the domain is a known disposable provider
`role_account`	Whether it's a role address (info@, admin@, etc.)
`free`	Whether it's a free provider (Gmail, Yahoo, etc.)
`suggestion`	Typo correction suggestion (e.g., gmial.com → gmail.com)

Error Responses

Status	Error	Meaning
400	`email_required`	No email provided
400	`invalid_level`	Level must be 1 or 2
401	`auth_required`	Not authenticated
401	`license_required`	No active license