Help Center
❯ AtData Services ❯ Email Validation
Why migrate?
AtData’s SafeToSend® service is where the company is adding new functionality and focusing future Product & Engineering efforts. In order to take advantage of existing enhancements and future upgrades, you’ll need to migrate to AtData SafeToSend.
By upgrading to AtData’s SafeToSend Email Verification and Hygiene, you’ll benefit from:
- Machine Learning-based spam trap detection
- AtData’s robust Real-time API and our List API, which can be used to quickly process customer files for Email Validation, Email Intelligence or Identity Matching
- A more comprehensive set of integration options with email service providers to easily connect and sync your data
- An enhanced List Guard® with improved reporting, a user interface, and ESP integrations
- The AtData Engagement Score*, which goes beyond validation to tell you if an email address is active
- A faster, more fault tolerant architecture with geographic load-balancing across the U.S.
*Please note that Engagement Score is included for free in SafeToSend for all AtData subscription customers.
The key differences between the legacy FreshAddress and AtData’s SafetoSend API are changes to the email response codes returned with your validation data. Whereas FreshAddress provides results using findings and comments, AtData SafeToSend describes results with a status and a numerical status code as shown in the API response of both services below.
FreshAddress SafeToSend |
AtData SafeToSend |
{
“EMAIL”: “[email protected]”,
“FINDING”: “W”,
“COMMENT”: “invalid email account”,
“COMMENT_CODE”: “B”,
“SUGG_EMAIL”: “”,
“SUGG_COMMENT”: “suggestion not SafeToSend”,
“ERROR_RESPONSE”: “The email address you entered cannot be registered”,
“ERROR”: “”,
“UUID”: “67e1d87b-730d-4029-a086-dbbcd18667b9”
}
|
{
“safe_to_send”: {
“status”: “invalid”
“status_code”: 400,
“address”: “[email protected]”,
“domain_type”: “biz”,
}
}
|
AtData SafeToSend Statuses – Quick Summary:
- safetosend – The email address passed all checks of the SafeToSend process, is safe to mail, and is backed by our deliverability guarantee.
- valid – The email address passed the majority of SafeToSend checks; however, it could not be confirmed as deliverable and may still bounce.
- invalid – Do not mail. The email is invalid. It may lack the proper syntax, the domain may be dead, the mailbox does not exist, etc.. (see the list of codes for more granular details on invalid)
- trap – The email address is a spam trap, honeypot, disposable, or high risk. Don’t send email to these risky addresses that can impact your email delivery. References to FreshAddress ‘W – Warning – XP, XF” should be updated to ‘trap’.
- corrected – The email address is invalid because it had a syntax or spelling error, we fixed it and we validated the correction. This status only appears during batch processing and is not present in the real-time API.
Compare the above statuses to those found in the FreshAddress SafeToSend:
- Finding “V” – valid:
- valid SafeToSend – The email address passed 100% of the SafeToSend process.
- valid – The email address passed the majority of our SafeToSend process however it cannot be 100% confirmed as deliverable and thus is not subject to our deliverability guarantee.
- customer override or client exception
- Finding “W” – Warning – email is invalid, suspicious, flagged
- Finding “D” – Duplicate
- Finding “E” – Error
- Ex: contains typos, bad top level domain, ends with a period
Since the AtData status codes are numerical values, all references to FreshAddress comments or comment codes must be updated when migrating to AtData SafeToSend.
In some cases, there are direct matches for individual codes. For example:
- Valid CO/CE – customer override would be covered by:
- valid 55 – Address is allowed by client-configured exceptions
- W – Warning XE – EMPS suppression XE – Email addresses belonging to DMA’s “Do Not Email List” would be covered by:
- trap 535 -Address is on ANA’s “Do Not Email List”
- W – Warning – XP, XF (problematic or frequent complainer) would be covered by:
- “trap” in AtData’s SafeToSend (the address is a spamtrap, a known complainer or is suppressed);
Also, AtData’s SafeToSend provides detailed list of invalid codes (codes 100-520).
Some of these match with FreshAddress codes fairly neatly. For example, error codes A1, A2, A3, A4, C1, CC, DT, LN, ML, P2, P3, P4, P5 in FreshAddress are covered by invalid codes 100-215 in AtData’s SafeToSend. However, some of the FreshAddress “Warning” codes are also considered “invalid” in AtData’s SafeToSend.
To make this easier to understand, below is a detailed breakdown of how all the statuses compare in the AtData SafeToSend Output vs the legacy FreshAddress output:
AtData SafeToSend Output |
|
FreshAddress SafeToSend Output |
Status |
Code |
Description |
|
Status |
Code |
Description |
unknown |
5 |
Timeout. Did not get a response in time. |
|
valid |
V |
valid – The email address passed the majority of our SafeToSend process however it cannot be 100% confirmed as deliverable and thus is not subject to our deliverability guarantee. |
valid |
10 |
Syntax OK. |
|
valid |
20 |
Syntax OK and the domain is valid. |
|
valid |
45 |
Domain is a catch all and does not support validation. |
|
safetosend |
50 |
valid – SafeToSend – The email address passed 100% of the SafeToSend process. Subject to deliverability guarantee. |
|
valid (STS) |
VS |
valid – SafeToSend – The email address passed 100% of the SafeToSend process. Subject to deliverability guarantee. |
valid |
55 |
Address is allowed by client-configured exceptions |
|
valid |
CO/CE |
customer override |
invalid |
100 |
General syntax error. |
|
E – Error |
A1, A2, A3, A4, C1, CC, DT, LN, ML, P2, P3, P4, P5 |
Various invalid error: missing domain, multiple @,bad character ,double .com ,bad length,contains multiple typos,ends with period,period following @,starts with a period, etc…. |
invalid |
110 |
Invalid character in address. |
|
invalid |
115 |
Invalid domain syntax. |
|
invalid |
120 |
Invalid username syntax. |
|
invalid |
125 |
Invalid username syntax for that domain. |
|
invalid |
130 |
Address is too long. |
|
invalid |
135 |
Address has unbalanced parentheses. |
|
invalid |
140 |
Address doesn’t have a username. |
|
invalid |
145 |
Address doesn’t have a domain. |
|
invalid |
150 |
Address doesn’t have an @ sign. |
|
invalid |
155 |
Address has more than one @ sign. |
|
invalid |
200 |
Invalid top-level domain (TLD) in address. |
|
invalid |
205 |
IP address is not allowed as a domain. |
|
invalid |
210 |
Address contains an extra space or character. |
|
invalid |
215 |
Unquoted spaces not allowed in email addresses. |
|
invalid |
255 |
Address is not allowed by client-configured suppressions |
|
W – Warning |
XC |
client restricted – Email address matches an entry on client provided suppression. |
invalid |
310 |
Domain doesn’t exist. |
|
W – Warning |
DC, XH |
bad domain DC Email address is associated with a domain with inactive mail servers. bogus XB NO Email address with a restricted handle and/or domain; error XH Email address failed a domain specific rule, e.g. gmail.com does not allow underscores in the address handle. |
invalid |
315 |
Domain doesn’t have a valid IP address. |
|
invalid |
325 |
Domain can’t receive email. |
|
invalid |
400 |
Mailbox doesn’t exist. |
|
invalid |
410 |
The mailbox is full and can’t receive email. |
|
invalid |
420 |
Mail isn’t accepted for this domain. |
|
invalid |
500 |
Emails with that username aren’t accepted. |
|
invalid |
505 |
Emails with that domain aren’t accepted. |
|
invalid |
510 |
That address isn’t accepted. |
|
W – Warning |
B |
invalid email account B Email address failed FreshAddress’s deliverability check. |
invalid |
515 |
Address was rejected during our manual review process |
|
|
invalid |
520 |
Address matched to known bouncers (optional feature). |
|
|
trap |
525 |
Address is a spamtrap, a known complainer or is suppressed. |
|
W – Warning |
XP, XF |
problematic or frequent complainer - Email address is considered as problematic – includes spamtraps and potentially toxic addresses. role account XR NO Email addresses such as sales@, info@ and webmaster@. frequent complainer XF Email address owner is known to submit spam/abuse complaints.or |
risky |
530 |
Address has opted out from commercial email. |
|
|
risky |
535 |
Address is on ANA’s “Do Not Email List” |
|
W – Warning |
XE |
EMPS suppression XE Email addresses belonging to DMA’s “Do Not Email List” |
unknown |
999 |
System error. |
|
|
removed |
|
W – Warning |
XW |
FCC wireless XW Email address originates from an FCC wireless domain. |
Files and Delivery Methods
FreshAddress supports:
1) FreshAddress Portal
2) SFTP
3) Real-time API
AtData SafeToSend supports:
1) InstantData Portal
2) SFTP
3) Real-time API
4) List API
File Contents
AtData’s SafeToSend adds six fields to your email list:
- Verification Status
- Verification Code
- Domain Type
- Role Account
- Duplicate
- Valid Email
Compared to FreshAddress SafeToSend which includes the following fields:
- Unique ID
- Email Address
- FINDING
- COMMENT
- COMMENT_CODE
- Sugg_Email
- Sugg_Comment
API Comparison
FA API Output |
AD STS API Output |
Example API Call & Result (w/ suggestion) |
Invalid Email Request with Correction |
GET https://[REQUEST URL]&[email protected] |
GET https://api.towerdata.com/v5/ev?email=info@@atdata,com&api_key={API-Key} |
{
“EMAIL”: “[email protected]”,
“FINDING”: “V”,
“COMMENT”: “valid”,
“COMMENT_CODE”: “V”,
“SUGG_EMAIL”: “[email protected]”,
“SUGG_COMMENT”: “”,
“ERROR_RESPONSE”: “”,
“ERROR”: “”,
“UUID”: “be6190ec-9a2d-4ca7-9e6a-5b3455838f8e”
}
|
{
“safe_to_send”: {
“status”: “invalid”,
“status_code”: 155,
“address”: “info@@atdata,com”,
“role_account”: true,
“email_corrections”: [
]
}
}
|
If you have additional questions regarding AtData’s SafeToSend, we encourage you to review our full SafeToSend documentation or contact us.