Global Email:Domain-Only Verification
| Global Email Navigation | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
| ||||||||
| ||||||||
| ||||||||
| 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": " "
}
]
}