Validate an email address

Request

Use this endpoint to verify a single email address.

Query

formatstring

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

Default:"XML"

Enum:"JSON""XML"

Example:format=JSON

idstring, (password)required

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.
BounceCheck:< on | off > - Conditionally triggers a real-time test message to the mail server for a given mailbox. Default is off.
CorrectSyntax:< on | off > - Allow correction of the mailbox name to fix common syntax issues. 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.
- Premium - A real time check is performed to determine email deliverability. This is the default option.
WhoIsLookup:< on | off > - Activates domain information Lookups. Default is on.

Example:opt=TimeToWait:10,WhoIsLookup:off

tstring

Serves as a unique request identifier.

Example:t=DemoTest

emailstringrequired

Required. The email address to be verified.

Example:email=info@Melissa.com

Acceptstringrequired

Format of the response.

Enum:"application/json""*/*"

Example:*/*

Content-Typestringrequired

Format of the request.

Enum:"application/json""application/xml"

curl -i -X GET \
  'https://globalemail.melissadata.net/v4/WEB/GlobalEmail/doGlobalEmail?id=%7BREPLACE-WITH-YOUR-LICENSE-KEY%7D&email=info%40Melissa.com' \
  -H 'Accept: */*' \
  -H 'Content-Type: application/json'

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": "9.4.1.4393",
  "TransmissionReference": "DemoTest",
  "TransmissionResults": "",
  "TotalRecords": "1",
  "Records": [
    { … }
  ]
}