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
| 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/ |
ValidateEmailAddress Outputs
| 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] 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.