Email Verification API

https://lumail.io/api/v1/emails/verify

Validates an email address for syntax, domain existence, and other quality factors before adding it to your subscriber list.

Response

• Success (200 OK) - Returns the verification result.
• Error (500 Internal Server Error) - Returned if verification fails due to a server error.

Response Fields

Field	Type	Description
isValid	boolean	Overall validity of the email address
address	string	The email address that was verified
domain	string	The domain portion of the email address
message	string	Human-readable explanation of the verification result
isFree	boolean	Whether the email is from a free provider (gmail.com, yahoo.com, etc.)
isDisposable	boolean	Whether the email is from a disposable/temporary email service
isRoleAccount	boolean	Whether the email is a role account (admin@, info@, support@, etc.)
hasMailServer	boolean	Whether the domain has mail servers configured
hasValidMX	boolean	Whether the domain has valid MX records

Request Schema

{
  "email": "string" // Required: Email address to verify
}

Usage Example

Use this API endpoint to validate email addresses before adding them to your subscriber list. It helps maintain list quality and reduce bounce rates by checking for:

• Syntax validation (proper email format)
• Domain existence and validity
• Mail server configuration
• Detection of disposable or temporary email domains
• Identification of free email providers
• Recognition of role-based accounts (like info@, support@)

Integrating this verification step into your signup forms and subscriber import processes can significantly improve your email deliverability and sender reputation.