Reference Guide

Introduction

Welcome to the Global Email Service by Melissa. Validate and parse email addresses, correct common typographical errors, and standardize email addresses. Features real-time email mailbox verification which removes up to 99% of bad emails.

Base URL

https://globalemail.melissadata.net

Licensing

The License Key is a software key required to use the web service. You will receive your license key from your Melissa representative. If you don’t have a license key, contact the Melissa sales team at Sales@Melissa.com or 800-MELISSA ext. 3 (800-635-4772 ext. 3). Without a license key, Global Email will not function.

To set the license key, use the id/CustomerID property in your requests.

Endpoints

/V4/WEB/GlobalEmail/doGlobalEmail

Use this endpoint to use all the email address verification abilities of Global Email.

Try It Now

Note

Make sure to replace {{customerId}} with your license key.

Get it here!

• GET JSON
• POST JSON
• GET XML
• POST XML

curl -X GET "https://globalemail.melissadata.net/v4/WEB/GlobalEmail/doGlobalEmail?\
&format=JSON\
&id={{customerId}}\
&opt=VerifyMailbox:Express,DomainCorrection:OFF,TimeToWait:25\
&t=Test\
&email=info@melissa.com" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

curl -X POST "https://globalemail.melissadata.net/v4/WEB/GlobalEmail/doGlobalEmail" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
       "CustomerID": "{{customerId}}",
       "Options": "VerifyMailbox:Express,DomainCorrection:OFF,TimeToWait:25",
       "Records":
       [{
          "Email": "info@melissa.com",
          "RecordID": "1"
       },{
          "Email": "sales@melissa.com",
          "RecordID": "2"
       }],
       "TransmissionReference": "test"
    }'

curl -X GET "https://globalemail.melissadata.net/v4/WEB/GlobalEmail/doGlobalEmail?\
&format=xml\
&id={{customerId}}\
&opt=VerifyMailbox:Express,DomainCorrection:OFF,TimeToWait:25\
&t=Test\
&email=info@melissa.com" \
-H "Content-Type: application/xml" \
-H "Accept: */*"

curl -X POST "https://globalemail.melissadata.net/v4/WEB/GlobalEmail/doGlobalEmail" \
-H "Content-Type: application/xml" \
-H "Accept: */*" \
-d '<Request>
       <CustomerID>{{customerId}}</CustomerID>
       <Options>VerifyMailbox:Express,DomainCorrection:OFF,TimeToWait:25</Options>
       <Records>
          <RequestRecord>
             <Email>info@melissa.com</Email>
             <RecordID>1</RecordID>
          </RequestRecord>
          <RequestRecord>
             <Email>sales@melissa.com</Email>
             <RecordID>2</RecordID>
          </RequestRecord>
       </Records>
       <TransmissionReference>Test</TransmissionReference>
    </Request>'

Request Parameters

• GET JSON
• POST JSON
• GET XML
• POST XML

Code	Description
Request Level Parameters
format	Specify the desired format of the response (XML or JSON). Defaults to XML.
id	The License Key issued by Melissa.
opt	Set Options AllowQuotes DomainCorrection TimeToWait VerifyMailBox WhoIsLookup
t	Optional. Serves as a unique request identifier.
Record Level Parameters
email	The email address to be verified.

Code	Description
Request Level Parameters
CustomerID	The License Key issued by Melissa.
Format	Specify the desired format of the response (XML or JSON). Defaults to XML.
Options	Set Options AllowQuotes DomainCorrection TimeToWait VerifyMailBox WhoIsLookup
TransmissionReference	Optional. Serves as a unique request identifier.
Record Level Parameters
Email	The email address to be verified.
RecordID	A unique identifier for the current record.

Code	Description
Request Level Parameters
format	Specify the desired format of the response (XML or JSON). Defaults to XML.
id	The License Key issued by Melissa.
opt	Set Options AllowQuotes DomainCorrection TimeToWait VerifyMailBox WhoIsLookup
t	Optional. Serves as a unique request identifier.
Record Level Parameters
email	The email address to be verified.

Code	Description
Request Level Parameters
CustomerID	The License Key issued by Melissa.
Format	Specify the desired format of the response (XML or JSON). Defaults to XML.
Options	Set Options AllowQuotes DomainCorrection TimeToWait VerifyMailBox WhoIsLookup
TransmissionReference	Optional. Serves as a unique request identifier.
Record Level Parameters
Email	The email address to be verified.
RecordID	A unique identifier for the current record.

Options

List options in the following format, with multiple options delimited with a ,.

OptionName:Parameter,OptionName:Parameter

AllowQuotes

Parameter	Description
On	Default. Allow double-quoted mailbox names. This allows special characters and whitespace within a valid quoted string.
Off	Do not allow double-quoted mailbox names. Illegal special characters and whitespace will be stripped.

DomainCorrection

Parameter	Description
On	Default. Activates fuzzy email domain correction if the domain is a suspected typo.
Off	No email domain correction.

TimeToWait

TimeToWait allows you to select how long (in seconds) that you would like our web service to wait on a single email before it times out. Select a smaller number if time is of essence, or longer if you would prefer more accurate results.

Parameter	Description
[5 - 45]	Default set to 25 . Select how long the web service will wait before it times out on an email.

VerifyMailBox

Express

The Express option of Global Email will use cached mailbox validations, so any submitted emails will be checked against a database of known bad and known good emails. Any emails that are sent into the EXPRESS will also be cached so they can be looked up during a 90-day cycle. Use this option for increased cost savings or where speed and performance are of upmost importance.

Premium

The Premium option always does the most comprehensive type of real-time checking by using domain-specific logic as well as SMTP commands and other proprietary mechanisms to validate email boxes. Use the PREMIUM option when you absolutely require the highest level of Mailbox verification. Bear in mind it can sometimes take up to 12 seconds to verify an email box. Applications that are time sensitive in nature should be programmed to call the express mode instead.

Parameter	Description
Express	Default. Quickly validates against database of known email addresses.
Premium	A real time check is performed to determine email deliverability.

WhoIsLookup

Parameter	Description
On	Default. Activates domain information Lookups.
Off	Deactivates domain information Lookups.

Headers

• GET JSON
• POST JSON
• GET XML
• POST XML

Content-Type: application/json
Accept: application/json

Content-Type: application/json
Accept: application/json

Content-Type: application/xml
Accept: */*

Content-Type: application/xml
Accept: */*

Response

• GET JSON
• POST JSON
• GET XML
• POST XML

{
   "Version": "7.2.1.4253",
   "TransmissionReference": "Test",
   "TransmissionResults": "",
   "TotalRecords": "1",
   "Records":
   [{
      "RecordID": "1",
      "DeliverabilityConfidenceScore": "61",
      "Results": "ES01,ES07,ES21",
      "EmailAddress": "test@melissa.com",
      "MailboxName": "test",
      "DomainName": "melissa",
      "DomainAuthenticationStatus": "",
      "TopLevelDomain": "com",
      "TopLevelDomainName": "Commercial",
      "DateChecked": "5/25/2023 12:23:32 AM",
      "EmailAgeEstimated": "2072",
      "DomainAgeEstimated": "9867",
      "DomainExpirationDate": "2023-09-14T23:00:00",
      "DomainCreatedDate": "1995-09-15T23:00:00",
      "DomainUpdatedDate": "2022-09-13T12:15:20",
      "DomainEmail": "",
      "DomainOrganization": "Domains By Proxy, LLC",
      "DomainAddress1": "DomainsByProxy.com 2155 E Warner Rd",
      "DomainLocality": "Tempe",
      "DomainAdministrativeArea": "Arizona",
      "DomainPostalCode": "85284",
      "DomainCountry": "UNITED STATES",
      "DomainAvailability": "UNAVAILABLE",
      "DomainCountryCode": "US",
      "DomainPrivateProxy": "1",
      "PrivacyFlag": "N",
      "MXServer": "",
      "DomainTypeIndicator": "Business/Organization",
      "BreachCount": ""
   }]
}

{
   "Version": "7.2.1.4253",
   "TransmissionReference": "Test",
   "TransmissionResults": "",
   "TotalRecords": "2",
   "Records":
   [{
      "RecordID": "1",
      "DeliverabilityConfidenceScore": "61",
      "Results": "ES01,ES07,ES21",
      "EmailAddress": "info@melissa.com",
      "MailboxName": "info",
      "DomainName": "melissa",
      "DomainAuthenticationStatus": "",
      "TopLevelDomain": "com",
      "TopLevelDomainName": "Commercial",
      "DateChecked": "5/11/2023 7:08:48 PM",
      "EmailAgeEstimated": "2022",
      "DomainAgeEstimated": "9867",
      "DomainExpirationDate": "2023-09-14T23:00:00",
      "DomainCreatedDate": "1995-09-15T23:00:00",
      "DomainUpdatedDate": "2022-09-13T12:15:20",
      "DomainEmail": "",
      "DomainOrganization": "Domains By Proxy, LLC",
      "DomainAddress1": "DomainsByProxy.com 2155 E Warner Rd",
      "DomainLocality": "Tempe",
      "DomainAdministrativeArea": "Arizona",
      "DomainPostalCode": "85284",
      "DomainCountry": "UNITED STATES",
      "DomainAvailability": "UNAVAILABLE",
      "DomainCountryCode": "US",
      "DomainPrivateProxy": "1",
      "PrivacyFlag": "N",
      "MXServer": "",
      "DomainTypeIndicator": "Business/Organization",
      "BreachCount": ""
   },{
      "RecordID": "2",
      "DeliverabilityConfidenceScore": "61",
      "Results": "ES01,ES07,ES21",
      "EmailAddress": "test@melissa.com",
      "MailboxName": "test",
      "DomainName": "melissa",
      "DomainAuthenticationStatus": "",
      "TopLevelDomain": "com",
      "TopLevelDomainName": "Commercial",
      "DateChecked": "5/25/2023 12:23:32 AM",
      "EmailAgeEstimated": "2072",
      "DomainAgeEstimated": "9867",
      "DomainExpirationDate": "2023-09-14T23:00:00",
      "DomainCreatedDate": "1995-09-15T23:00:00",
      "DomainUpdatedDate": "2022-09-13T12:15:20",
      "DomainEmail": "",
      "DomainOrganization": "Domains By Proxy, LLC",
      "DomainAddress1": "DomainsByProxy.com 2155 E Warner Rd",
      "DomainLocality": "Tempe",
      "DomainAdministrativeArea": "Arizona",
      "DomainPostalCode": "85284",
      "DomainCountry": "UNITED STATES",
      "DomainAvailability": "UNAVAILABLE",
      "DomainCountryCode": "US",
      "DomainPrivateProxy": "1",
      "PrivacyFlag": "N",
      "MXServer": "",
      "DomainTypeIndicator": "Business/Organization",
      "BreachCount": ""
   }]
}

<Response
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   xmlns="urn:mdGlobalEmail">
   <Version>7.2.1.4253</Version>
   <TransmissionReference>Test</TransmissionReference>
   <TransmissionResults />
   <TotalRecords>1</TotalRecords>
   <Records>
      <ResponseRecord>
         <RecordID>1</RecordID>
         <DeliverabilityConfidenceScore>61</DeliverabilityConfidenceScore>
         <Results>ES01,ES07,ES21</Results>
         <EmailAddress>info@melissa.com</EmailAddress>
         <MailboxName>info</MailboxName>
         <DomainName>melissa</DomainName>
         <DomainAuthenticationStatus />
         <TopLevelDomain>com</TopLevelDomain>
         <TopLevelDomainName>Commercial</TopLevelDomainName>
         <DateChecked>5/11/2023 7:08:48 PM</DateChecked>
         <EmailAgeEstimated>2023</EmailAgeEstimated>
         <DomainAgeEstimated>9867</DomainAgeEstimated>
         <DomainExpirationDate>2023-09-14T23:00:00</DomainExpirationDate>
         <DomainCreatedDate>1995-09-15T23:00:00</DomainCreatedDate>
         <DomainUpdatedDate>2022-09-13T12:15:20</DomainUpdatedDate>
         <DomainEmail />
         <DomainOrganization>Domains By Proxy, LLC</DomainOrganization>
         <DomainAddress1>DomainsByProxy.com 2155 E Warner Rd</DomainAddress1>
         <DomainLocality>Tempe</DomainLocality>
         <DomainAdministrativeArea>Arizona</DomainAdministrativeArea>
         <DomainPostalCode>85284</DomainPostalCode>
         <DomainCountry>UNITED STATES</DomainCountry>
         <DomainAvailability>UNAVAILABLE</DomainAvailability>
         <DomainCountryCode>US</DomainCountryCode>
         <DomainPrivateProxy>1</DomainPrivateProxy>
         <PrivacyFlag>N</PrivacyFlag>
         <MXServer />
         <DomainTypeIndicator>Business/Organization</DomainTypeIndicator>
         <BreachCount />
      </ResponseRecord>
   </Records>
</Response>

<Response
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xmlns:xsd="http://www.w3.org/2001/XMLSchema"
   xmlns="urn:mdGlobalEmail">
   <Version>7.2.1.4253</Version>
   <TransmissionReference>Test</TransmissionReference>
   <TransmissionResults />
   <TotalRecords>2</TotalRecords>
   <Records>
      <ResponseRecord>
         <RecordID>1</RecordID>
         <DeliverabilityConfidenceScore>61</DeliverabilityConfidenceScore>
         <Results>ES01,ES07,ES21</Results>
         <EmailAddress>info@melissa.com</EmailAddress>
         <MailboxName>info</MailboxName>
         <DomainName>melissa</DomainName>
         <DomainAuthenticationStatus />
         <TopLevelDomain>com</TopLevelDomain>
         <TopLevelDomainName>Commercial</TopLevelDomainName>
         <DateChecked>5/11/2023 7:08:48 PM</DateChecked>
         <EmailAgeEstimated>2023</EmailAgeEstimated>
         <DomainAgeEstimated>9867</DomainAgeEstimated>
         <DomainExpirationDate>2023-09-14T23:00:00</DomainExpirationDate>
         <DomainCreatedDate>1995-09-15T23:00:00</DomainCreatedDate>
         <DomainUpdatedDate>2022-09-13T12:15:20</DomainUpdatedDate>
         <DomainEmail />
         <DomainOrganization>Domains By Proxy, LLC</DomainOrganization>
         <DomainAddress1>DomainsByProxy.com 2155 E Warner Rd</DomainAddress1>
         <DomainLocality>Tempe</DomainLocality>
         <DomainAdministrativeArea>Arizona</DomainAdministrativeArea>
         <DomainPostalCode>85284</DomainPostalCode>
         <DomainCountry>UNITED STATES</DomainCountry>
         <DomainAvailability>UNAVAILABLE</DomainAvailability>
         <DomainCountryCode>US</DomainCountryCode>
         <DomainPrivateProxy>1</DomainPrivateProxy>
         <PrivacyFlag>N</PrivacyFlag>
         <MXServer />
         <DomainTypeIndicator>Business/Organization</DomainTypeIndicator>
         <BreachCount />
      </ResponseRecord>
      <ResponseRecord>
         <RecordID>2</RecordID>
         <DeliverabilityConfidenceScore>55</DeliverabilityConfidenceScore>
         <Results>ES01,ES07,ES21</Results>
         <EmailAddress>sales@melissa.com</EmailAddress>
         <MailboxName>sales</MailboxName>
         <DomainName>melissa</DomainName>
         <DomainAuthenticationStatus />
         <TopLevelDomain>com</TopLevelDomain>
         <TopLevelDomainName>Commercial</TopLevelDomainName>
         <DateChecked>5/16/2022 1:40:17 PM</DateChecked>
         <EmailAgeEstimated>2010</EmailAgeEstimated>
         <DomainAgeEstimated>9867</DomainAgeEstimated>
         <DomainExpirationDate>2023-09-14T23:00:00</DomainExpirationDate>
         <DomainCreatedDate>1995-09-15T23:00:00</DomainCreatedDate>
         <DomainUpdatedDate>2022-09-13T12:15:20</DomainUpdatedDate>
         <DomainEmail />
         <DomainOrganization>Domains By Proxy, LLC</DomainOrganization>
         <DomainAddress1>DomainsByProxy.com 2155 E Warner Rd</DomainAddress1>
         <DomainLocality>Tempe</DomainLocality>
         <DomainAdministrativeArea>Arizona</DomainAdministrativeArea>
         <DomainPostalCode>85284</DomainPostalCode>
         <DomainCountry>UNITED STATES</DomainCountry>
         <DomainAvailability>UNAVAILABLE</DomainAvailability>
         <DomainCountryCode>US</DomainCountryCode>
         <DomainPrivateProxy>1</DomainPrivateProxy>
         <PrivacyFlag>N</PrivacyFlag>
         <MXServer />
         <DomainTypeIndicator>Business/Organization</DomainTypeIndicator>
         <BreachCount />
      </ResponseRecord>
   </Records>
</Response>

Service Level Response Fields

Output Name	Description
TotalRecords	Total number of records.
TransmissionReference	A pass-through of the input TransmissionReference field.
TransmissionResults	Lists error codes from any errors caused by the most recent request as a whole.
Version	The current service version number.

Record Level Response Fields

Output Name	Description
Breach Count	The known number of breaches that this email account has been involved in.
DateChecked	The date the email was validated. It returns UTC, Unix Time (Epoch Time) in the MM/DD/YYYY H:MM:SS format.
DeliverabilityConfidenceScore	The probability [0-100]% of an email sent to this mailbox will be successfully delivered.
Domain Type Indicator	Predicts if email belongs to a personal or business/organization email by analyzing the domain.
DomainAddress1	The address of the DomainOrganization.
DomainAdministrativeArea	The state of the DomainOrganization.
DomainAgeEstimated	The estimated age of the domain in days.
DomainAuthenticationStatus	The security protocols used on the receiving mail server.
DomainAvailability	Check to see if domain is available for purchase.
DomainCountry	The country of the DomainOrganization.
DomainCountryCode	The country code of the DomainCountry.
DomainCreatedDate	The date the domain was created in the YYYY-MM-DDTHH:MM:SS format.
DomainEmail	The email associated with the domain owner.
DomainExpirationDate	The date the domain expires/expired in the YYYY-MM-DDTHH:MM:SS format. This is When the domain will be renewed or available to buy.
DomainLocality	The city of the DomainOrganization.
DomainName	The domain name portion of the email address. (All characters between the “@” and “.” characters.).
DomainOrganization	The company associated with the domain owner.
DomainPostalCode	The postal code of the DomainOrganization.
DomainPrivateProxy	Check if domain is behind a private proxy.
DomainUpdatedDate	The date the domain was last updated in the YYYY-MM-DDTHH:MM:SS format.
EmailAddress	The email address or domain, including any correcctions or updates made by Global Email.
EmailAgeEstimated	The estimated minimum age of the email in days based on historical data. The value is zero when we lack historical data on a given email.
MailboxName	The mailbox or user name portion of the email address (Everything before the “@” in the email address).
MXServer	Premium only. The Mail Exchange (MX) Server used to validate the email.
PrivacyFlag	Is this email affected by additional privacy reglations, such as GDPR. Returns Y for yes and N for no.
RecordID	The number of the record. Always 1 for a single email request, otherwise it serves as an index of the array of records.
Results	Comma delimited status, error codes, and change codes for the record.
TopLevelDomain	The description associated with the top-level domain name of the email address (e.g. com is Commercial).
TopLevelDomainName	The top level domain name portion of the email address (All characters after the “.”, e.g. com).

/V4/WEB/GlobalEmail/getVersion

Introduction

Use the getVersion endpoint to check your Global Email version and ensure you’re up to date.

Try It Now

• GET JSON

curl -X GET "https://globalemail.melissadata.net/v4/WEB/GlobalEmail/getVersion" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

Headers

• GET JSON

Content-Type: application/json
Accept: application/json

Response

• GET JSON

{
   "ServiceName": "Global Email",
   "Version": "7.2.1.4253",
   "mdMicroServices_Version": "1.2.1.5368",
   "CustomerIDCheckVersion": "7.2.1.5374",
   "EventReportVersion": "7.2.1.5340",
   "RequestLogVersion": "7.2.1.5352",
   "ResourceStoreVersion": "7.2.1.5333",
   "emailLibService_Version": "7.2.1.17282",
   "BuildNumber": "17282",
   "DatabaseDate": "2023-02-15",
   "ExpirationDate": "2023-08-15"
}

Input Best Practices

While text encoding is a rare issue with email addresses, note that Global Email will not support any wrongly-encoded special characters or non-Latin characters. In general, text encoding is an important part of any data enterprise.

This service can deal with multiple languages and scripts. It expects UTF-8 encoding. Be on the lookout for question marks (?), squares (▖) or other unwanted characters like �. They may be an indication of encoding issues and may result in data loss. Bad encoding or character loss is not something our service can correct for you.

Result Codes

Interpreting Results

Deliverability Confidence Score (Basic)

Global Email includes a DeliverabilityConfidenceScore (DCS) with each email.

The DCS is a single number in range 0-100 that represents how confident we are that an email will successfully send. It can be used as a quicker and simpler way to filter emails, either as a first step before diving into result codes, or for a single pass of data cleansing.

DCS is not simply a numerical representation of our result codes, though. We leverage various reference data to further refine DCS, which also makes it dynamic - even more dynamic than our existing result codes.

While certain use cases will vary, our general recommendation for using DCS is:

Danger

Don’t send an email with a confidence score below 30.

DCS	Recommendation
0 to 30	Do not send
31 to 60	Email delivery not guaranteed
61 to 100	Send email. There is a high chance of email delivery success

Result Codes (Advanced)

Result codes yield more granular information about a given email. They are returned as a comma-delimited string of 4-character alpha-numeric codes, e.g. ES01,ES07,ES21 or EE04,ES22.

ES## and EE## Codes

The ES## and EE## codes (Email Status and Email Error) are returned alongside each email record in a request.

SE## and GE## Codes

The SE## and GE## codes (Transmission Service Error and General Transmission Error) are used to signify more general errors, and are returned under the key TransmissionResults in the outermost level of our responses.

Using Result Codes

In general, we recommend using the equivalent of a string.contains() method to check our result codes.

Looking for exact matches between two result code strings could result in false negatives, since a valid email could come back with either “ES01,ES21” or “ES01,ES22,” where the only difference between those two is the last character, signifying that one was retrieved from our cache and the other in real-time.

Pseudocode

While our result codes allow for very granular analysis, a general use case could entail something like the following:

# Pythonic pseudocode

resultCodeStr = "ES01,ES10,ES22"
# This indicates that the email is valid based on a real-time check,
# and that we successfully fixed the syntax of the original input.

if resultCodeStr.contains("ES01"):
   # valid email
   handleGoodEmail()
elif resultCodeStr.contains("ES10"):
   # you may want to update your records with our fixed email
   handleFixedEmail()
elif resultCodeStr.contains("EE"):
   # any one or more EE## codes indicates a bad email
   handleBadEmail()

# Few users will need to account for every single individual result
# code, but more granular analysis beyond the above is easily
# implemented.

While changes in result codes are rare outside of major releases, using string.contains() or equivalent is the most future-proof way to handle our result codes.

For example, the result code ES02 was deprecated after Global Email version 3. However, even with version 3, any email that came back with ES02 always had at least one EE## code as well, so any implementation using EE## codes to filter out bad emails would have been forward compatible with no changes needed.

We believe result codes are especially useful for marketing campaigns involving high volumes of emails. Such campaigns are sensitive to problems such as spam traps and accept-all emails, as both of those factors could lead to significantly decreased ROI. While these factors are reflected in the Deliverability Confidence Score, we recommend explicitly filtering out and handling such emails for applications such as marketing campaigns.

Please refer to the FAQ: What is an accept all mail server?, for more information on accept-all emails and why they are a problem in the world of email verification and email marketing.

Common Result Code Recommendations

The following table shows the most common result codes seen while using Global Email, and our recommendations for how to interpret them.

Code	Description	Recommendataion for Marketing	Recommendataion for Point of Entry
ES01	Valid Email	Accept	Accept
ES03	Unknown Email	Reject	Caution
ES21	Verify (Precision: Cached Mailbox Result)	Accept	Accept
ES22	Verify (Precision: Real-time Mailbox Result)	Accept	Accept
EE01	Email Syntax Error	Reject	Reject
EE02	Email Domain Not Found	Reject	Reject
EE03	Email Server Not Found	Reject	Reject
EE04	Invalid Email	Reject	Reject

Service Level Result Codes

Note

The Service Level result codes apply to the service as a whole.

Tip

For best practices on when to send an email based off of the result code, see: Result Code Best Practices

Code	Short Description	Long Description
Transmission Service Error
SE01	Cloud Service Internal Error	The cloud service experienced an internal error.
General Transmission Error
GE01	Empty Request Structure	The SOAP, JSON, or XML request structure is empty. Not to be confused with the GE01 GeoCode result code.
GE02	Empty Request Record Structure	The SOAP, JSON, or XML request record structure is empty. Not to be confused with the GE02 GeoCode result code.
GE03	Records Per Request Exceeded	The counted records sent more than the number of records allowed per request.
GE04	Empty License Key	The License Key is empty.
GE05	Invalid License Key	The License Key is invalid.
GE06	Disabled License Key	The License Key is disabled.
GE07	Invalid Request	The SOAP, JSON, or XML request is invalid.
GE08	Product/Level Not Enabled	The License Key is invalid for this product or level.
GE09	Customer Does Not Exist	The Customer ID is not in our system.
GE10	Customer License Disabled	The encrypted license is on the ban list.
GE11	Customer Disabled	The Customer ID is disabled.
GE12	IP Blacklisted	The IP Address is on the global ban list.
GE13	IP Not Whitelisted	The IP Address is not on the customer’s whitelist.
GE14	Out of Credits	The account has ran out of credits. Add more credits to continue using the service.

Record Level Result Codes

Note

The Record Level result codes apply to the individual request records.

Tip

For example input that returns specific codes, see the FAQ: What are some examples of input that returns specific codes?

Code	Short Description	Long Description
ES - Email Status
ES01	Valid Email	This email was confirmed to be a valid email.
ES03	Unknown Email	This email’s status is unknown due to unknown external factors. Please try again another time.
ES04	Mobile Email Address	The domain name was identified as a mobile email address and classified as not deliverable by the FCC.
ES05	Disposable Domain	The domain name of the submitted email was identified as a disposable domain.
ES06	Spamtrap Domain	The domain name of the submitted email was identified as a spamtrap. Mailing to this domain could result in the sender being blacklisted.
ES07	Accept All Server	The mail server is an accept all server. Accept-All domains is set in a way that makes all emails seem valid.
ES08	Role Address	This Email address was created as a group, ex: sales@, support@, or postmaster@.
ES09	Protected Mailbox Caution	The mail provider for this email address may be quick to classify senders as spam and will not respond to our requests. Mailbox validation is not possible at this time and the mailbox may or may not exist. We recommend proceeding with caution if emailing numerous records to this mail domain.
ES10	Syntax Changed	The syntax of the submitted email address was changed.
ES11	Top Level Domain Changed	The top level domain of the submitted email address was changed.
ES12	Domain Changed (Spelling)	The domain of the submitted email address was corrected for spelling.
ES13	Domain Changed (Update)	The domain of the submitted email address was updated due to a domain name change.
ES20	Verify (Precision: Domain Result)	The email is considered valid, but did not have the mailbox verified and not found in our mailbox database.
ES21	Verify (Precision: Cached Mailbox Result)	The mailbox was found to be already validated in our mailbox database.
ES22	Verify (Precision: Real-time Mailbox Result)	The mailbox validation was performed in real-time.
ES23	Verify (Precision: Unicode Result)	Unicode Detected: We do not support Unicode at this time for realtime mailbox validation. Domain and cache check only.
ES24	Verify (Precision: Pending Mailbox Result)	The mail provider has been known to send a delayed response so it is possible that the pending status will change within the next 24 hours. You may want to resubmit this input at a later time as an update may be possible.
ES30	Privacy Flag (TLD)	The top level domain may be sensitive to privacy laws.
ES31	Suspicious Characters	This email address has suspicious characters or characters which are not in the ASCII character set.
ES36	Spamtrap Mailbox	Indicates that we predict this email address is a spamtrap mailbox. Mailing to this specific mailbox could result in the sender being blacklisted.
ES37	Breach Flag	This email has been exposed in a data breach.
EE - Email Error
EE01	Email Syntax Error	There is a syntax error in the submitted email address.
EE02	Email Domain Not Found	A Domain of the submitted email address was not found.
EE03	Email Server Not Found	The mail server of the submitted email address was not found.
EE04	Invalid Email	An invalid mailbox was detected (i.e. noreply).
DE - Domain Error
DE03	Domain Not Found	The domain is not a registered domain name.
DV - Domain Verified
DV01	Domain Found	The domain is a valid registered domain name.