NOTE: Use starttime and endtime for optimal performance. Data returned will be greater than or equal to (>=) starttime and less than (<) endtime.

HTTP Action — GET

URIs — http://emailapi.dynect.net/rest/RETURN-TYPE/reports/bounces[PARAMS]

Click for RETURN-TYPE information

• apikey — Required. API key of the account with the desired information.
• starttime — Required. Start date/time range in full, ISO 8601 format
• endtime — Required. End date/time range in full, ISO 8601 format
• sender — Email address of sender for filtering.
• emailaddress — Email address of recipient for filtering.
• startindex — Number indicating where to begin reporting results.
• noheaders — Determines whether or not headers are included in the response. Valid values: 1 = Exclude bounce header content from the response. 0 = Default. Include headers in response.
• [X-HeaderName] — Name of searchable custom X-header. X-header names are in the format X-[name of header]. X-header values are the search parameter to find in the X-header field. Be sure to url-encode the search value.
  NOTE: When setting X-Header values, it is important to avoid using the greater than (<) and lesser than (>) symbols in your X-Header values. A valid X-Header value looks like this: “some_xheader_value_string_here”
• bouncetype — Type of bounce for filtering. Valid Values: hard, soft, previouslyhardbounced, previouslycomplained, or suppressed.
  • hard – attempted delivery fatally failed.
  • soft – attempted delivery failed with transient, temporary, or
otherwise non-fatal reason.
  • previouslyhardbounced – recipient had previously hard-bouncedand has been added to your suppression list.
  • previouslycomplained – recipient had previously registered a spam
complaint and has been added to your suppression list.
  • suppressed – recipient was manually added to the suppression list.

  
  

  bouncerule – Bounce rules are apart of the bouncetype response. They types of bounce rules are defined below.
  • badmailbox – non-existent recipient.
  • blockedcontent – indicates email content has been classified as spam by the receiving email provider.
  • contentrelated – indicates email content has been classified as spam by the receiving email provider.
  • emaildoesntexist – non-existent recipient.
  • inactive – recipient inactive / mailbox disabled / etc.
  • localconfigerror – Dyn’s sending MTA has a experienced an issue.
  • mailboxfull – recipient mailbox is full
  • messagetoolarge – total message size, including headers, exceeds the receiving email provider’s allowed maximum message size.
  • notacceptingmessages – receiving email provider is not accepting messages.
  • other
  • overquota – recipient mailbox is full.
  • policyrelated – indicates email has been classified as spam by the receiving email provider.
  • previouslycomplained – recipient previously registered a spam complaint.
  • previouslyhardbounced – recipient previously hard-bounced.
  • relayerror – error in transmission between Dyn and the email provider.
  • remoteconfigerror – a configuration problem at the receiving email provider caused delivery to fail.
  • spamrelated – email has been classified as spam by the receiving email provider.
  • unclassifiedcode – unknown or unclassified reason.

{"response":{"status":200,"message":"OK","data":{"bounces":[{"bouncetype":"hard","bouncerule":"emaildoesntexist","bounceemail":"email@domain.org",
"bouncemessage":"MESSAGE_HERE","bouncetime":"2004-02-12T15:19:21+00:00","notified":"","X-SubscriberID":"486"},…]}}}