Global Email:Domain-Only Verification

From Melissa Data Wiki
Revision as of 16:35, 26 August 2020 by Admin (talk | contribs) (Created page with "{{GlobalEmailV4Nav |BasicsCollapse= }} {{CustomTOC}} Build 4.0.0.13 added a new domain-only mode, allowing you to verify only d...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

← Global Email

Global Email Navigation
Basics
Introduction
Licensing
Domain-Only Verification
Privacy and Global Email
Best Practices
FAQ
Service URLs
Input/Output
Request Fields
Response Fields
Examples
REST JSON
REST JSONP
REST XML
Batch XML
Batch JSON
Interpreting Results
Deliverability Confidence Score (Basic)
Result Codes (Advanced)
Global Email Result Codes
Sample Code



Build 4.0.0.13 added a new domain-only mode, allowing you to verify only domains. The domain is passed in using the same parameter as email addresses, and you receive the same results about the domain as you would with an email at that domain.

Request Fields

Simply pass in a domain using the same parameter as you would for an email, omitting the mailbox. In other words, pass the @ and everything after it. E.g. @gmail.com.

You can even mix emails and domains within a single batch request.

Response Fields

Domain-only mode reuses our existing response format, but leaves anything related to emails blank.

Domain-only mode uses just two new result codes that are returned in the same fields as all existing result codes.

Result Code Description
DV00 Invalid domain
DV01 Valid domain


Sample Requests and Responses

Single REST Request

https://globalemail.melissadata.net/v4/WEB/GlobalEmail/doGlobalEmail?&id=<your_ident_here>&opt=&format=JSON&email=@gmail.com

Single REST Response

{
    "Version": "4.0.0.13",
    "TransmissionReference": "",
    "TransmissionResults": " ",
    "TotalRecords": "1",
    "Records": [
        {
            "RecordID": "1",
            "Results": "DV01",
            "DeliverabilityConfidenceScore": "0",
            "EmailAddress": "@gmail.com",
            "MailboxName": " ",
            "DomainName": " ",
            "TopLevelDomain": "",
            "TopLevelDomainName": " ",
            "DateChecked": " ",
            "DomainAgeEstimated": "9126",
            "DomainExpirationDate": "2021-08-11T07:00:00",
            "DomainCreatedDate": "1995-08-13T07:00:00",
            "DomainUpdatedDate": "2020-07-11T09:32:49",
            "DomainEmail": " ",
            "DomainOrganization": "Google LLC",
            "DomainAddress1": " ",
            "DomainLocality": " ",
            "DomainAdministrativeArea": "CA",
            "DomainPostalCode": " ",
            "DomainCountry": "UNITED STATES",
            "DomainCountryCode": "US",
            "DomainAvailability": "UNAVAILABLE",
            "DomainPrivateProxy": " ",
            "PrivacyFlag": " ",
            "MXServer": " "
        }
    ]
}

Batch JSON Request (mixed domains and emails)

{
  "TransmissionReference": "",
  "CustomerID": "your_ident_here",
  "Options": "",
  "Records": [
    {
      "RecordID": 1,
      "Email": "test@gmail.com"
    },
    {
      "RecordID": 2,
      "Email": "@aol.com"
    },
    {
      "RecordID": 3,
      "Email": "test@yahoo.com"
    },
    {
      "RecordID": 4,
      "Email": "@melissa.com"
    },
    {
      "RecordID": 5,
      "Email": "test@hotmail.com"
    }
  ]
}

Batch JSON Response (mixed domains and emails)

{
    "Version": "4.0.0.13",
    "TransmissionReference": "",
    "TransmissionResults": " ",
    "TotalRecords": "5",
    "Records": [
        {
            "RecordID": "1",
            "Results": "EE04,ES21",
            "DeliverabilityConfidenceScore": "0",
            "EmailAddress": "test@gmail.com",
            "MailboxName": "test",
            "DomainName": "gmail",
            "TopLevelDomain": "com",
            "TopLevelDomainName": "Commercial",
            "DateChecked": "6/19/2020 4:33:55 PM",
            "DomainAgeEstimated": "9126",
            "DomainExpirationDate": "2021-08-11T07:00:00",
            "DomainCreatedDate": "1995-08-13T07:00:00",
            "DomainUpdatedDate": "2020-07-11T09:32:49",
            "DomainEmail": " ",
            "DomainOrganization": "Google LLC",
            "DomainAddress1": " ",
            "DomainLocality": " ",
            "DomainAdministrativeArea": "CA",
            "DomainPostalCode": " ",
            "DomainCountry": "UNITED STATES",
            "DomainCountryCode": "US",
            "DomainAvailability": "UNAVAILABLE",
            "DomainPrivateProxy": " ",
            "PrivacyFlag": "N",
            "MXServer": " "
        },
        {
            "RecordID": "2",
            "Results": "DV01",
            "DeliverabilityConfidenceScore": "0",
            "EmailAddress": "@aol.com",
            "MailboxName": " ",
            "DomainName": " ",
            "TopLevelDomain": "",
            "TopLevelDomainName": " ",
            "DateChecked": " ",
            "DomainAgeEstimated": "9181",
            "DomainExpirationDate": "2021-11-23T12:02:22",
            "DomainCreatedDate": "1995-06-22T04:00:00",
            "DomainUpdatedDate": "2020-07-30T18:35:29",
            "DomainEmail": "domain-admin@oath.com",
            "DomainOrganization": "Oath Inc.",
            "DomainAddress1": "22000 AOL Way",
            "DomainLocality": "Dulles",
            "DomainAdministrativeArea": "VA",
            "DomainPostalCode": "20166",
            "DomainCountry": "UNITED STATES",
            "DomainCountryCode": "US",
            "DomainAvailability": "UNAVAILABLE",
            "DomainPrivateProxy": " ",
            "PrivacyFlag": " ",
            "MXServer": " "
        },
        {
            "RecordID": "3",
            "Results": "EE04,ES21",
            "DeliverabilityConfidenceScore": "0",
            "EmailAddress": "test@yahoo.com",
            "MailboxName": "test",
            "DomainName": "yahoo",
            "TopLevelDomain": "com",
            "TopLevelDomainName": "Commercial",
            "DateChecked": "3/30/2020 2:58:39 PM",
            "DomainAgeEstimated": "9337",
            "DomainExpirationDate": "2023-01-19T05:00:00",
            "DomainCreatedDate": "1995-01-18T08:00:00",
            "DomainUpdatedDate": "2020-07-30T18:35:29",
            "DomainEmail": "domain-admin@oath.com",
            "DomainOrganization": "Oath Inc.",
            "DomainAddress1": "22000 AOL Way",
            "DomainLocality": "Dulles",
            "DomainAdministrativeArea": "VA",
            "DomainPostalCode": "20166",
            "DomainCountry": "UNITED STATES",
            "DomainCountryCode": "US",
            "DomainAvailability": "UNAVAILABLE",
            "DomainPrivateProxy": " ",
            "PrivacyFlag": "N",
            "MXServer": " "
        },
        {
            "RecordID": "4",
            "Results": "DV01",
            "DeliverabilityConfidenceScore": "0",
            "EmailAddress": "@melissa.com",
            "MailboxName": " ",
            "DomainName": " ",
            "TopLevelDomain": "",
            "TopLevelDomainName": " ",
            "DateChecked": " ",
            "DomainAgeEstimated": "9054",
            "DomainExpirationDate": "2020-09-15T04:00:00",
            "DomainCreatedDate": "1995-09-16T04:00:00",
            "DomainUpdatedDate": "2019-09-15T13:34:32",
            "DomainEmail": " ",
            "DomainOrganization": " ",
            "DomainAddress1": " ",
            "DomainLocality": " ",
            "DomainAdministrativeArea": "California",
            "DomainPostalCode": " ",
            "DomainCountry": "UNITED STATES",
            "DomainCountryCode": "US",
            "DomainAvailability": "UNAVAILABLE",
            "DomainPrivateProxy": " ",
            "PrivacyFlag": " ",
            "MXServer": " "
        },
        {
            "RecordID": "5",
            "Results": "ES03",
            "DeliverabilityConfidenceScore": "50",
            "EmailAddress": "test@hotmail.com",
            "MailboxName": "test",
            "DomainName": "hotmail",
            "TopLevelDomain": "com",
            "TopLevelDomainName": "Commercial",
            "DateChecked": "2/25/2020 10:20:37 PM",
            "DomainAgeEstimated": "8902",
            "DomainExpirationDate": "2021-03-28T04:00:00",
            "DomainCreatedDate": "1996-03-27T05:00:00",
            "DomainUpdatedDate": "2020-05-20T19:23:42",
            "DomainEmail": "domains@microsoft.com",
            "DomainOrganization": "Microsoft Corporation",
            "DomainAddress1": "One Microsoft Way,",
            "DomainLocality": "Redmond",
            "DomainAdministrativeArea": "WA",
            "DomainPostalCode": "98052",
            "DomainCountry": "UNITED STATES",
            "DomainCountryCode": "US",
            "DomainAvailability": "UNAVAILABLE",
            "DomainPrivateProxy": " ",
            "PrivacyFlag": "N",
            "MXServer": " "
        }
    ]
}