EmailValidate - Email address validation web service

Home | Demo | Developers | Contact

Developer spec and implementation

The code samples below illustrate basic integration to the API using a SOAP toolkit. Implementation will vary according to the programming language used. Web service requests against EmailValidate require credentials. To request an AccountID and AccountKey, please go to our Contact page.

A successful request (Response.ResponseCode of "0") will return a populated Response.EmailStatus array containing the email address sent in on the request. Simply iterate through each element to check against a variety of statuses. Review the following tables for more information:

Web method request

Field	Type	Comments
AccountID	string	Numeric
AccountKey	string	GUID
EmailAddress	string array	Single or multiple emails

Web method response

Field	Type	Comments
ResponseCode	string	0, 201, 202, 203, 999, ...
ResponseMessage	string	Success, Error, ...
EmailStatus	object array	Refer to next table...

Response.EmailStatus

Field	Type	Comments
EmailAddress	string	Single email
IsSyntaxValid	boolean	True or False
IsMXRecordValid	boolean	True or False
IsSMTPValid	boolean	True or False

* Note: This web service is currently in a pilot phase. There is a current limit of 5 requests with a rolling expiration of 10 minutes from the last request (with a max of 5 email addresses per request). Throttling and availability may change without notice.

Web service URL
http://www.emailvalidate.net/API.asmx?WSDL

Web service SOAP envelope and HTTP POST examples
http://www.emailvalidate.net/API.asmx?op=EmailValidate

Code sample: Validate single email address


    EmailValidate.API api = new MiscTestApp.EmailValidate.API();
    EmailValidate.Response response = new MiscTestApp.EmailValidate.Response();

    response = api.EmailValidate("123", "123", new string[] { "mailbox@domain.com" });

    if (response.ResponseCode == "0")
        Console.WriteLine("Syntax Check: {0} = {1}", response.EmailStatus[0].EmailAddress, response.EmailStatus[0].IsSyntaxValid.ToString());
    else
        Console.WriteLine(response.ResponseMessage);

Code sample: Validate multiple email addresses with one API call


    EmailValidate.API api = new MiscTestApp.EmailValidate.API();
    EmailValidate.Response response = new MiscTestApp.EmailValidate.Response();

    string[] emails = new string[5];
    emails[0] = "mailbox@domain1.com";
    emails[1] = "mailbox@domain2.com";
    emails[2] = "mailbox@domain3.com";
    emails[3] = "mailbox@domain4.com";
    emails[4] = "mailbox@domain5.com";

    response = api.EmailValidate("123", "123", emails);

    if (response.ResponseCode == "0")
    {
        for (int i = 0; i < response.EmailStatus.Length; i++)
        {
            Console.WriteLine("SMTP Check: {0} = {1}", response.EmailStatus[i].EmailAddress, response.EmailStatus[i].IsSMTPValid.ToString());
        }
    }
    else
    {
        Console.WriteLine(response.ResponseMessage);
    }