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. 

URL Endpoints

ValidateEmailAddress Inputs

NameTypeDescription

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


StringThis 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

StringYour 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

ValidateEmailAddress Outputs 

NameTypeValuesDescription
Score [1]
Integer0
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
Stringtrue
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
VariesThe cleaned and corrected email. This is the email that is validated.

EmailCorrected
BooleanT/F
Indicates if any corrections or modifications were made to the email address.

BoxStringVariesThe part to the left of the ‘@’ symbol. Also known as the local part or the username.

DomainStringVariesThe part to the right of the ‘@’ symbol. The location to which the email address will be sent.

TopLevelDomain

StringVariesThe part after the rightmost ‘.’

TopLevelDomainDescription

StringVariesDescription of the Top Level Domain.

IsSMTPServerGood

Stringtrue
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]

String0-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

StringVariesContains the warning flag(s) that corresponds to the Warning Codes. Returns zero or more warning flags in a comma-separated list.[3]

NotesCodes
String0-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
VariesContains the note flag(s) that corresponds to the Notes Codes. Returns zero or more notes flags in a comma-separated list.[3]

Error
ErrorVariesError object indicating why the service could not return a result.

References

  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