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

System Requirements#

  • SSL/TLS 1.2+

Getting Started - What Can I Do?#

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

Sample Code#

Language

Repository

C# .NET

melissa_favicon MelissaData/GlobalEmail-Dotnet

Python3

melissa_favicon MelissaData/GlobalEmail-Python

Postman Collection

melissa_favicon MelissaData/GlobalEmail-Postman