Reports and Statistics

Statistics

Via the SMTP2GO API, you can quickly retrieve statistics to help monitor your deliverability, bounce rate, account status and much more.

Below is a short summary of each report.

Email Bounces

This report will give you statistics on your email bounces for the last 30 days. The API will return:

  • emails - Number of emails sent
  • rejects - Number of emails rejected
  • softbounces - Number of emails soft bounced by receiving mail servers
  • hardbounces - Number of emails hard bounced by receiving mail servers
  • bounce_percent - Percentage of email bounces, compared to total emails sent.

Email Cycle

This report will give you statistics on the SMTP2GO account. The API will return:

  • cycle_start - The date of the start of your current monthly email cycle
  • cycle_end - The date of the end of your current monthly email cycle
  • cycle_max - The maximum number of emails you can send during this monthly email cycle, based on your plan's monthly allowance
  • cycle_used - The number of emails you have sent during this monthly email cycle
  • cycle_remaining - The remaining number of emails that you can send during this monthly email cycle, based on your plan's monthly allowance.

Email History

This report will give you a summary of emails sent during the specified date range (defaults to last 30 days), per sender email address or SMTP username. The API will return:

  • count - Total quantity of emails sent during the specified date range (defaults to last 30 days)
  • history - An array of statistics as follows:
    • email_address - The sender email address used to send emails from your SMTP2GO account
    • lastip - The last IP used to send an email from the specified email_address
    • used - The quantity of emails sent from the specified email_address
    • bytecount - The total count of bytes sent via emails from the specified email_address
    • avgsize - The average size (in bytes) sent via emails from the specified email_address.

Email Spam

This report will give you a summary of how receiving mail servers handled your emails. The API will return:

  • emails - Total quantity of emails sent during the last 30 days
  • spams - Total quantity of emails marked as 'Spam' by receiving email servers
  • rejects - Total quantity of emails rejected by receiving email servers
  • spam_percent - Percentage of emails marked as 'Spam' by receiving email servers, compared to total emails sent.

Email Unsubscribes

This report will give you a summary of how many recipients unsubscribed from emails that you sent. The API will return:

  • emails - Total quantity of emails sent during the last 30 days
  • unsubscribes - Total quantity of unsubscribes received
  • rejects - Total quantity of emails rejected by receiving email servers
  • unsubscribe_percent - Percentage of unsubscribes received, compared to total emails sent.

Email Summary

This report will give you a summary of all other reports. The API will return:

  • bounce_rejects - Number of emails rejected
  • softbounces - Number of emails soft bounced by receiving mail servers
  • hardbounces - Number of emails hard bounced by receiving mail servers
  • bounce_percent - Percentage of email bounces, compared to total emails sent.
  • cycle_start - The date of the start of your current monthly email cycle
  • cycle_end - The date of the end of your current monthly email cycle
  • cycle_max - The maximum number of emails you can send during this monthly email cycle, based on your plan's monthly allowance
  • cycle_used - The number of emails you have sent during this monthly email cycle
  • cycle_remaining - The remaining number of emails that you can send during this monthly email cycle, based on your plan's monthly allowance
  • spam_emails - Total quantity of emails marked as 'Spam' by receiving email servers
  • spam_rejects - Total quantity of emails rejected by receiving email servers
  • spam_percent - Percentage of emails marked as 'Spam' by receiving email servers, compared to total emails sent
  • unsubscribes - Total quantity of unsubscribes received
  • unsubscribe_percent - Percentage of unsubscribes received, compared to total emails sent
  • email_count - Number of emails sent.

Search Account Activity

Using the API, you can search activities such as opens, clicks and unsubscribes on your account.

The maximum number of activities to return from a search is 100, and should the results span beyond the current page, your response will include a continue_token. To retrieve further items, pass your continue_token using the same search parameters.

You can search across sender search_sender, recipient search_recipient and more. Details are found on the View Activity endpoint page.

Each activity will have one of the following event_type values below:

  • processed
  • soft-bounced
  • hard-bounced
  • rejected
  • spam
  • delivered
  • unsubscribed
  • resubscribed
  • opened
  • clicked

Example

Search for opens and clicks recorded where the email subject includes the word 'booking'. Limit this to the most recent result.

{
    "api_key":"api-554407F347FB4689A35C07377E61B7D5",
    "search_subject": "Booking",
    "event_types": ["opened", "clicked"],
    "only_latest": true,
    "limit": 1
}