Global Email Quickstart#

Introduction#

The Global Email Service by Melissa validates and parses email addresses, corrects common typographical errors, and standardizes email addresses. It also features real-time email mailbox verification which removes up to 99% of bad emails.

Global Email can be used to:

  • Correct syntax errors (remove illegal characters, extra “@” characters etc.)

  • Verify and correct top-level domains

  • Correct common misspellings in domain names

  • Update domains that have changed

  • Standardize casing

  • Validate emails against our database (single or batch requests)

  • Perform real-time mailbox validation

New to Melissa Cloud APIs?#

We highly recommend first time users of our Cloud APIs to review our Using Melissa Cloud APIs section. It will cover critical topics like:

System Requirements#

  • SSL/TLS 1.2+

Getting Started - What Can I Do?#

Explore Melissa Lookups#

Check out Global Email lookups here for the full experience.

Check an Email#

Global Email can check to see if a given email address is valid and we can even give a simplified confidence score on the deliverability of an email address.

Endpoint#

/V4/WEB/GlobalEmail/doGlobalEmail

Click here to go to the full endpoint documentation.

Try it Now#

  • 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>
   '

Verify a Mailbox Delivery#

Global Email can try and verify if an email address has been delivered to a mailbox.

Endpoint#

/V4/WEB/GlobalEmail/doGlobalEmail

Click here to go to the full endpoint documentation.

Try it Now#

  • 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:Premium\
&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:Premium",
      "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:Premium\
&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:Premium</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>'

Verify Only Domains#

Global Email can verify only the domain of an email address. You pass in the domain (everything after the @) and receive results about just the domain.

Endpoint#

/V4/WEB/GlobalEmail/doGlobalEmail

Click here to go to the full endpoint documentation.

Try it Now#

  • GET JSON
  • POST JSON
  • GET XML
  • POST XML
curl -X GET "https://globalemail.melissadata.net/v4/WEB/GlobalEmail/doGlobalEmail?\
&format=JSON\
&id={{customerId}}\
&opt=\
&t=Test\
&email=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": "",
      "Records":
      [{
         "Email": "melissa.com",
         "RecordID": "1"
      },{
         "Email": "gmail.com",
         "RecordID": "2"
      }],
      "TransmissionReference": "Test"
    }'
curl -X GET "https://globalemail.melissadata.net/v4/WEB/GlobalEmail/doGlobalEmail?\
&format=xml\
&id={{customerId}}\
&opt=\
&t=Test\
&email=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></Options>
      <Records>
        <RequestRecord>
          <Email>melissa.com</Email>
          <RecordID>1</RecordID>
        </RequestRecord>
        <RequestRecord>
          <Email>gmail.com</Email>
          <RecordID>2</RecordID>
        </RequestRecord>
      </Records>
      <TransmissionReference>Test</TransmissionReference>
    </Request>'

Inputs and Outputs#

The table below shows the most common inputs and outputs for this service.

For full details on the inputs see the Request Parameters and for a complete list of the outputs see the Response fields.

  • GET JSON
  • POST JSON

Inputs

Outputs

Request Level Parameters

format

id

opt

t

Record Level Parameters

email

Service Level Response Fields

Version

TransmissionReference

TransmissionResults

TotalRecords

Records

Record Level Response Fields

RecordID

DeliverabilityConfidenceScore

Results

EmailAddress

MailboxName

DomainName

DomainAuthenticationStatus

TopLevelDomain

TopLevelDomainName

DateChecked

EmailAgeEstimated

DomainAgeEstimated

DomainExpirationDate

DomainCreatedDate

DomainUpdatedDate

DomainEmail

DomainOrganization

DomainAddress1

DomainLocality

DomainAdministrativeArea

DomainPostalCode

DomainCountry

DomainAvailability

DomainCountryCode

DomainPrivateProxy

PrivacyFlag

MXServer

DomainTypeIndicator

BreachCount

ActivityLevel

Inputs

Outputs

Request Level Parameters

CustomerID

Options

TransmissionReference

Record Level Parameters

Email

RecordID

Service Level Response Fields

Version

TransmissionReference

TransmissionResults

TotalRecords

Records

Record Level Response Fields

RecordID

DeliverabilityConfidenceScore

Results

EmailAddress

MailboxName

DomainName

DomainAuthenticationStatus

TopLevelDomain

TopLevelDomainName

DateChecked

EmailAgeEstimated

DomainAgeEstimated

DomainExpirationDate

DomainCreatedDate

DomainUpdatedDate

DomainEmail

DomainOrganization

DomainAddress1

DomainLocality

DomainAdministrativeArea

DomainPostalCode

DomainCountry

DomainAvailability

DomainCountryCode

DomainPrivateProxy

PrivacyFlag

MXServer

DomainTypeIndicator

BreachCount

ActivityLevel