Skip to content
/Email Validation

Global Email

Overview

The Global Email Cloud API 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

Documentation

Useful Resources

Product Page

https://www.melissa.com/email-verification

Support Center

https://www.melissa.com/company/product-support

Download OpenAPI description
global-email.json
global-email.yaml
Languages
Servers
Global Email Server
https://globalemail.melissadata.net/v4/WEB/GlobalEmail/

Email Validation

Use this endpoint to verify emails.

Operations

Validate an email address

Request

Uses HTTP GET to accept one input record and returns the response in JSON or XML format.

Query
formatstring

Format - Specify the desired format of the response (XML or JSON).

Default "XML"
Enum"JSON""XML"
Example: format=JSON
idstring(password)required

The License Key issued by Melissa.

Example: id={REPLACE-WITH-YOUR-LICENSE-KEY}
optstring

Options - List options in the format OptionName:Parameter, with multiple options delimited with a ,.

For example: OptionName:Parameter,OptionName:Parameter

  • AllowQuotes:< on | off > - Allow double-quoted mailbox names. This allows special characters and whitespace within a valid quoted string. Default is on.
  • DomainCorrection:< on | off > - Activates fuzzy email domain correction if the domain is a suspected typo. Default is on.
  • TimeToWait:< [5 - 45] >- Select how long the web service will wait before it times out on an email. Default set to 25.
  • VerifyMailbox:< Express | Premium >
    • Express - Quickly validates against database of known email addresses. This is the default option.
    • Premium - A real time check is performed to determine email deliverability.
  • WhoIsLookup:< on | off > - Activates domain information Lookups. Default is on.
Example: opt=TimeToWait:10,WhoIsLookup:off
tstring

Transmission Reference - Serves as a unique request identifier.

Example: t=Test
emailstringrequired

Email Address - The email address to be verified.

Example: email=info@Melissa.com
curl -i -X GET \
  'https://globalemail.melissadata.net/v4/WEB/GlobalEmail/doGlobalEmail?id={REPLACE-WITH-YOUR-LICENSE-KEY}&email=info%40Melissa.com'

Responses

Successful response

Body
Versionstring

The current service version number.

TransmissionReferencestring

A pass-through of the input TransmissionReference field.

TransmissionResultsstring

Lists error codes from any errors caused by the most recent request as a whole. For more information, see Global Email Result Codes.

TotalRecordsstring

Total number of records.

RecordsArray of objects
Response
{
  "Version": "7.2.1.4253",
  "TransmissionReference": "Test",
  "TransmissionResults": "",
  "TotalRecords": "1",
  "Records": [
    { … }
  ]
}

Validate email addresses

Request

Body
required
CustomerIDstringrequired

The License Key issued by Melissa.

Formatstring

Specify the desired format of the response (XML or JSON).

Default "XML"
Enum"JSON""XML"
Optionsstring

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

OptionName:Parameter,OptionName:Parameter

  • AllowQuotes:< on | off > - Allow double-quoted mailbox names. This allows special characters and whitespace within a valid quoted string. Default is on.
  • DomainCorrection:< on | off > - Activates fuzzy email domain correction if the domain is a suspected typo. Default is on.
  • TimeToWait:< [5 - 45] >- Select how long the web service will wait before it times out on an email. Default set to 25.
  • VerifyMailbox:< Express | Premium >
    • Express - Quickly validates against database of known email addresses. This is the default option.
    • Premium - A real time check is performed to determine email deliverability.
  • WhoIsLookup:< on | off > - Activates domain information Lookups. Default is on.
RecordsArray of objects[ 1 .. 100 ] itemsrequired
Records[].​Emailstring

The email address to be verified.

Records[].​RecordIDstring

Unique identifier for the record.

TransmissionReferencestring

Transmission Reference - Serves as a unique request identifier.

curl -i -X POST \
  https://globalemail.melissadata.net/v4/WEB/GlobalEmail/doGlobalEmail \
  -H 'Content-Type: application/json' \
  -d '{
    "CustomerID": "{REPLACE-WITH-YOUR-LICENSE-KEY}",
    "Format": "JSON",
    "Options": "TimeToWait:10,WhoIsLookup:off",
    "Records": [
      {
        "Email": "info@Melissa.com",
        "RecordID": "1"
      },
      {
        "Email": "sales@Melissa.com",
        "RecordID": "2"
      }
    ],
    "TransmissionReference": "Test"
  }'

Responses

Successful response

Body
Versionstring

The current service version number.

TransmissionReferencestring

A pass-through of the input TransmissionReference field.

TransmissionResultsstring

Lists error codes from any errors caused by the most recent request as a whole. For more information, see Global Email Result Codes.

TotalRecordsstring

Total number of records.

RecordsArray of objects
Response
{
  "Version": "7.2.1.4253",
  "TransmissionReference": "Test",
  "TransmissionResults": "",
  "TotalRecords": "2",
  "Records": [
    { … },
    { … }
  ]
}

Version

Use this endpoint to check the current version of Global Email.

Operations