3. Reports¶
3.1. dyn.mm.reports module¶
The reports module provides users with an interface to the entire /reporting functionality of the Dyn Message Management API. While date ranges are not explicitly required for some calls, it is strongly recommended that you include a date range in any call that can accepts one. Without a starting and ending date, the call will retrieve data for all time, which can take a very long time. If you are specifically looking for data over your entire time, it is much more efficient to retrieve the data one piece (i.e. month) at a time rather than to retrieve it all at once.
Also worth noting is Dyn’s delivery data retention policy: “DynECT Email Delivery data retention policy states that detail data is kept for 30 days, and aggregate (count) data is kept for 18 months. So please be aware as you search history, that it is likely no results will appear beyond 30 days.”
-
class
dyn.mm.reports.Bounce(starttime, endtime=None, startindex=0, sender=None, xheaders=None)[source]¶ Returns all email bounces for the specified account for the specified date range, optionally filtered by sender.
-
uri= '/reports/bounces'¶
-
-
class
dyn.mm.reports.Clicks(starttime, endtime=None, startindex=0, sender=None, xheaders=None, domain=None, recipient=None)[source]¶ Returns total number of clicks (or unique clicks) for the specified account for the specified date range. Including a date range is highly recommended.
-
uri= '/reports/clicks'¶
-
-
class
dyn.mm.reports.Complaint(starttime, endtime=None, startindex=0, sender=None, xheaders=None)[source]¶ Returns all spam complaints that the specified account received for the specified date range, optionally filtered by sender. Including a date range is highly recommended.
-
uri= '/reports/complaints'¶
-
-
class
dyn.mm.reports.Delivered(starttime, endtime=None, startindex=0, sender=None, xheaders=None)[source]¶ Returns all emails sent through the specified account that were successfully delivered for the specified date range, optionally filtered by sender. Including a date range is highly recommended.
-
uri= '/reports/delivered'¶
-
-
class
dyn.mm.reports.Issue(starttime, endtime=None, startindex=0, sender=None, xheaders=None)[source]¶ Returns all issues concerning the specified account for the specified date range. Including a date range is highly recommended.
-
uri= '/reports/issues'¶
-
-
class
dyn.mm.reports.Opens(starttime, endtime=None, startindex=0, sender=None, xheaders=None, domain=None, recipient=None)[source]¶ Returns total number of opens (or unique opens) for the specified account for the specified date range. Including a date range is highly recommended.
-
uri= '/reports/opens'¶
-