Global Email:Domain-Only Verification: Difference between revisions

From Melissa Data Wiki
Jump to navigation Jump to search
Created page with "{{GlobalEmailV4Nav |BasicsCollapse= }} {{CustomTOC}} Build 4.0.0.13 added a new domain-only mode, allowing you to verify only d..."
 
No edit summary
 
(2 intermediate revisions by the same user not shown)
Line 20: Line 20:
!Result Code!!Description
!Result Code!!Description
|-
|-
|DV00||Invalid domain
|DE03||Invalid domain
|-
|-
|DV01||Valid domain
|DV01||Valid domain
Line 33: Line 33:
<pre>
<pre>
{
{
     "Version": "4.0.0.13",
     "Version": "4.0.0.17",
     "TransmissionReference": "",
     "TransmissionReference": "",
     "TransmissionResults": " ",
     "TransmissionResults": " ",
Line 40: Line 40:
         {
         {
             "RecordID": "1",
             "RecordID": "1",
             "Results": "DV01",
             "Results": "DV01,EE01",
             "DeliverabilityConfidenceScore": "0",
             "DeliverabilityConfidenceScore": "0",
             "EmailAddress": "@gmail.com",
             "EmailAddress": "@gmail.com",
             "MailboxName": " ",
             "MailboxName": " ",
             "DomainName": " ",
             "DomainName": "gmail",
             "TopLevelDomain": "",
             "TopLevelDomain": "com",
             "TopLevelDomainName": " ",
             "TopLevelDomainName": " ",
             "DateChecked": " ",
             "DateChecked": " ",
Line 103: Line 103:
<pre>
<pre>
{
{
     "Version": "4.0.0.13",
     "Version": "4.0.0.17",
     "TransmissionReference": "",
     "TransmissionReference": "",
     "TransmissionResults": " ",
     "TransmissionResults": " ",
Line 137: Line 137:
         {
         {
             "RecordID": "2",
             "RecordID": "2",
             "Results": "DV01",
             "Results": "DV01,EE01",
             "DeliverabilityConfidenceScore": "0",
             "DeliverabilityConfidenceScore": "0",
             "EmailAddress": "@aol.com",
             "EmailAddress": "@aol.com",
             "MailboxName": " ",
             "MailboxName": " ",
             "DomainName": " ",
             "DomainName": "aol",
             "TopLevelDomain": "",
             "TopLevelDomain": "com",
             "TopLevelDomainName": " ",
             "TopLevelDomainName": " ",
             "DateChecked": " ",
             "DateChecked": " ",
Line 191: Line 191:
         {
         {
             "RecordID": "4",
             "RecordID": "4",
             "Results": "DV01",
             "Results": "DV01,EE01",
             "DeliverabilityConfidenceScore": "0",
             "DeliverabilityConfidenceScore": "0",
             "EmailAddress": "@melissa.com",
             "EmailAddress": "@melissa.com",
             "MailboxName": " ",
             "MailboxName": " ",
             "DomainName": " ",
             "DomainName": " ",
             "TopLevelDomain": "",
             "TopLevelDomain": "melissa",
             "TopLevelDomainName": " ",
             "TopLevelDomainName": "com",
             "DateChecked": " ",
             "DateChecked": " ",
             "DomainAgeEstimated": "9054",
             "DomainAgeEstimated": "9054",

Latest revision as of 23:21, 22 September 2020

← 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
DE03 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.17",
    "TransmissionReference": "",
    "TransmissionResults": " ",
    "TotalRecords": "1",
    "Records": [
        {
            "RecordID": "1",
            "Results": "DV01,EE01",
            "DeliverabilityConfidenceScore": "0",
            "EmailAddress": "@gmail.com",
            "MailboxName": " ",
            "DomainName": "gmail",
            "TopLevelDomain": "com",
            "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.17",
    "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,EE01",
            "DeliverabilityConfidenceScore": "0",
            "EmailAddress": "@aol.com",
            "MailboxName": " ",
            "DomainName": "aol",
            "TopLevelDomain": "com",
            "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,EE01",
            "DeliverabilityConfidenceScore": "0",
            "EmailAddress": "@melissa.com",
            "MailboxName": " ",
            "DomainName": " ",
            "TopLevelDomain": "melissa",
            "TopLevelDomainName": "com",
            "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": " "
        }
    ]
}
Retrieved from "http://wiki.melissadata.com/index.php?title=Global_Email:Domain-Only_Verification&oldid=17373"