Validates and verifies an email address via a full suite of tests and real-time SMTP checks. This operation performs real-time server-to-server verification via SMTP communication. This operation allows the user to specify a timeout value, in milliseconds, for how long it can take to perform SMTP level checks. A minimum of 200 milliseconds is required to perform these checks. However, results are dependent on the network speed of an email’s host, which may require several seconds to verify. Average mail server response times are approximately between 2-3 seconds, but some slower mail servers may take 15 seconds or more to verify.
 
Name Type Description
EmailAddress

 String

 The email address you wish to validate.
AllowCorrections String Accepts true or false. The service will attempt to correct an email address if set to true. Otherwise the email address will be left unaltered if set to false.
Timeout

 String This value specifies how long the service is allowed to wait for all real-time network level checks to finish. Real-time checks consist primarily of DNS and SMTP level verification. Timeout time is in milliseconds. A minimum value of 200ms is required.
LicenseKey

 String Your license key to use the service.
Sign up for a free trial key at
https://www.serviceobjects.com/email-validation/
*All input values are required
Name Type Values Description
Score [1] Integer 0
1
2
3
4		 An estimate on the validity of the email address.[1] 
0 = Email is Good
1 = Email is Probably Good
2 = Unknown
3 = Email is Probably Bad
4 = Email is Bad
IsDeliverable String true
false
unknown		 Indicates if the mail server will accept mail for the given email address.[2]
EmailAddressIn

 String

 Varies

 Echo of input: EmailAddress
EmailAddressOut String Varies The cleaned and corrected email. This is the email that is validated.
EmailCorrected Boolean T/F Indicates if any corrections or modifications were made to the email address.
Box String Varies The part to the left of the ‘@’ symbol. Also known as the local part or the username.
Domain String Varies The part to the right of the ‘@’ symbol. The location to which the email address will be sent.
TopLevelDomain

 String Varies The part after the rightmost ‘.’
TopLevelDomainDescription

 String Varies Description of the Top Level Domain.
IsSMTPServerGood

 String true
false
unknow		 Indicates if the email’s mail server is operational.
IsCatchAllDomain [2]

 String

 true
false
unknown		 Indicates if the mail server will accept mail to any box in that domain (*@domain).
IsSMTPMailBoxGood

 String

 true
false
unknown		 Indicates if the mail server will accept mail to the specific box.
WarningCodes [3]

 String 0-21

 Indicates if one or more potential problems were found when correcting, validating and/or verifying the email address. Returns zero or more numerical warning codes in a comma-separated list.[3]
WarningDescriptions

 String Varies Contains the warning flag(s) that corresponds to the Warning Codes. Returns zero or more warning flags in a comma-separated list.[3]
NotesCodes String 0-6 Displays additional notes about the email that were found during the validation process. Returns zero or more numerical note codes in a comma-separated list.[3]
NotesDescription String Varies Contains the note flag(s) that corresponds to the Notes Codes. Returns zero or more notes flags in a comma-separated list.[3]
Error Error Varies Error object indicating why the service could not return a result.
  1. ^ What’s in a Number? What Email Validation Scores Mean
  2. ^ Tackling False Positives in Email Validation
  3. ^ Email Validation – Terms You Should Know