Page tree
Skip to end of metadata
Go to start of metadata



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


JSON: 

https://trial.serviceobjects.com/ev3/web.svc/json/ValidateEmailAddress?EmailAddress={EMAILADDRESS}&AllowCorrections={ALLOWCORRECTIONS}&Timeout={TIMEOUT}&LicenseKey={LICENSEKEY}

XML: 

https://trial.serviceobjects.com/ev3/web.svc/xml/ValidateEmailAddress?EmailAddress={EMAILADDRESS}&AllowCorrections={ALLOWCORRECTIONS}&Timeout={TIMEOUT}&LicenseKey={LICENSEKEY}



ValidateEmailAddress Inputs


Name

Type

Description

EmailAddress

String

The email address you wish to validate.

AllowCorrectionsStringAccepts 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.
TimeoutStringThis 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/products/email/email-verification-service

*All input values are required
 

ValidateEmailAddress Outputs 


Name

Type

Values

Description

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
IsDeliverableStringtrue
false
unknown
Indicates if the mail server will accept mail for the given email address.[2]

EmailAddressIn

String

Varies

Echo of input: EmailAddress

EmailAddressOutStringVariesThe cleaned and corrected email. This is the email that is validated.
EmailCorrectedBooleanT/FIndicates 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
unknown

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]

NotesCodesString0-6Displays 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]
NotesDescriptionStringVariesContains the note flag(s) that corresponds to the Notes Codes. Returns zero or more notes flags in a comma-separated list.[3]
ErrorErrorVariesError object indicating why the service could not return a result.


[1] This value is dependent on the amount data that is available for the address. The service then analyzes the data to estimate the integrity of the address.

[2] An unknown return value indicates that either there was not enough information available about the recipient's mail server to determine deliverability or the server is a catch-all. In general, catch-all mail servers will always initially accept an email message, even if the email address does not exist.

[3] New codes and descriptions will be added as new features become available and the number of codes will increase in time. See the table for our current list of codes & descriptions.


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


  • No labels