Global Email:Domain-Only Verification: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
No edit summary |
||
| (One intermediate revision by the same user not shown) | |||
| Line 20: | Line 20: | ||
!Result Code!!Description | !Result Code!!Description | ||
|- | |- | ||
| | |DE03||Invalid domain | ||
|- | |- | ||
|DV01||Valid domain | |DV01||Valid domain | ||
| Line 33: | Line 33: | ||
<pre> | <pre> | ||
{ | { | ||
"Version": "4.0.0. | "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", | ||
| Line 103: | Line 103: | ||
<pre> | <pre> | ||
{ | { | ||
"Version": "4.0.0. | "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", | ||
| Line 191: | Line 191: | ||
{ | { | ||
"RecordID": "4", | "RecordID": "4", | ||
"Results": "DV01", | "Results": "DV01,EE01", | ||
"DeliverabilityConfidenceScore": "0", | "DeliverabilityConfidenceScore": "0", | ||
"EmailAddress": "@melissa.com", | "EmailAddress": "@melissa.com", | ||
Latest revision as of 23:21, 22 September 2020
| 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 |
|---|---|
| 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": " "
}
]
}