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
FieldTypeComments
AccountIDstringNumeric
AccountKeystringGUID
EmailAddressstring arraySingle or multiple emails

Web method response
FieldTypeComments
ResponseCodestring0, 201, 202, 203, 999, ...
ResponseMessagestringSuccess, Error, ...
EmailStatusobject arrayRefer to next table...

Response.EmailStatus
FieldTypeComments
EmailAddressstringSingle email
IsSyntaxValidbooleanTrue or False
IsMXRecordValidbooleanTrue or False
IsSMTPValidbooleanTrue 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);
    }
                
Copyright © 2009-2014 EmailValidate.net
Terms of Service | Privacy Policy

Sedo - Buy and Sell Domain Names and Websites project info: emailvalidate.net Statistics for project emailvalidate.net etracker® web controlling instead of log file analysis