bounceHammer have been downloaded and used by many users and companies since the first release on March 2010 and has been EOL: End Of Life on February 29, 2016. Thanks for using bounceHammer for a long time. We are now providing Sisimai (the successor of bounceHammer, more faster, more higher precision of analysis) as a bounce mail parser library in BSD 2-Clause License.
bounceHammer parses bounce email and outputs as a structured data (the format is YAML or JSON). It is ease to use from another programs with YAML/JSON library.
The followings are example of structured data which are created by bounceHammer. The structured data contains a record per line, is hash format such as "Key Name": "Value".
The first line of above means that it is a parsed data of email: From:firstname.lastname@example.org to To:email@example.com bounced at 2009-02-13 15:31:30(UNIX Time 1234567890), by the reason "userunknown"(Unknown User)".
bounced is the date which email has bounced. The date is displayed as a UNIX machine time(32 bits integer).
addressser is a sender email address. All of characters in the address are written in lowercase.
recipient is a recipient email address. All of characters in the address are written in lowercase like addresser.
senderdomain is a domain part of sender(From) email address. All of characters in the domain are written in lowercase like addresser, recipient.
destinationis a domain part of recipient(To) email address. All of characters in the domain are written in lowercase like addresser, recipient, and senderdomain.
reason is a bounce reason: Why the email bounced ? The list of classified bounce reason of bounceHammer is available at Reason page.
hostgroup is a classified host group of destination (domain part of recipient email addresss). The list of classified host group of bounceHammer is available a Host Group page.
provider is over the classification of hostgroup. The list of providers of bounceHammer is available at Provider page.
frequency stands for the number of bounced times of each combination: sender email address(addresser) and recipient email address(recipient).
description contains more information about email-bounce: Time zone offset, MTA name, Diagnostic code, List-ID, and Delivery status.
description/deliverystatus is a D.S.N.(Delivery Status Notifier) value written in Status: header of a bounce email. If there is no Status: header in a bounce email, bounceHammer generate an internal code as a value of Status: header.
description/diagnosticcode is a value written in Diagnostic-Code: header of a bounce email. If there is no Diagnostic-Code: header in a bounce email, bounceHammer write messages in the bounce email which used for detecting the reason.
Beginning with bounceHammer 2.7.10
description/listid is a value written in List-Id: header of a bounce email. List-Id: header contains mailling list name. It is useful to find a mailling list name which have any email bounce.
Beginning with bounceHammer 2.6.1
description/smtpagent is a MTA name which created its bounce email, such as Sendmail, Postfix, qmail, Exim , CourierMTA. If the bounce email is not supported by bounceHammer, this value is recorded 'Unknown'.
description/timezoneoffset is a time zone offset of a bounce email which its email has bounced. If bounceHammer has failed to get a value of time zone offset, this value is '+0000'.
Beginning with bounceHammer 2.7.11
description/messageid is the value of Message-Id header of the original message. When the original message which is included in a bounce email contains no Message-Id header(removed by remote MTA), this value will be empty.
Beginning with bounceHammer 2.7.11
description/subject is the value of Subject header of the original message. When the original message which is included in a bounce email contains no Subject header(removed by remote MTA), this value will be empty. If the value of Subject header of the original message contain any multibyte character(non ASCII character), such as MIME encoded Japanese or German and so on, the value of subject in parsed data is encoded with UTF-8 again.
token is an identifier of each email-bounce. the token string is created from a sender email address(addresser) and a recipient email address(recipient) as an MD5 hash value.
Message token value can be created by