Global Email:Domain-Only Verification: Difference between revisions

From Melissa Data Wiki
Jump to navigation Jump to search
Newer edit →
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
Line 44: Line 44:
             "EmailAddress": "@gmail.com",
             "EmailAddress": "@gmail.com",
             "MailboxName": " ",
             "MailboxName": " ",
             "DomainName": " ",
             "DomainName": "gmail",
             "TopLevelDomain": "",
             "TopLevelDomain": "com",
             "TopLevelDomainName": " ",
             "TopLevelDomainName": " ",
             "DateChecked": " ",
             "DateChecked": " ",
Line 141: Line 141:
             "EmailAddress": "@aol.com",
             "EmailAddress": "@aol.com",
             "MailboxName": " ",
             "MailboxName": " ",
             "DomainName": " ",
             "DomainName": "aol",
             "TopLevelDomain": "",
             "TopLevelDomain": "com",
             "TopLevelDomainName": " ",
             "TopLevelDomainName": " ",
             "DateChecked": " ",
             "DateChecked": " ",
Line 196: Line 196:
             "MailboxName": " ",
             "MailboxName": " ",
             "DomainName": " ",
             "DomainName": " ",
             "TopLevelDomain": "",
             "TopLevelDomain": "melissa",
             "TopLevelDomainName": " ",
             "TopLevelDomainName": "com",
             "DateChecked": " ",
             "DateChecked": " ",
             "DomainAgeEstimated": "9054",
             "DomainAgeEstimated": "9054",

Revision as of 22:34, 21 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
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": "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.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": "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",
            "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=17362"