Skip to main content
GET
/
account
/
subaccount
/
stat
/
{subaccount_id}
/
group
Get aggregated stats by group
curl --request GET \
  --url https://api.sendpost.io/api/v1/account/subaccount/stat/{subaccount_id}/group \
  --header 'X-Account-ApiKey: <api-key>'
{
  "processed": 22500,
  "delivered": 20000,
  "dropped": 1000,
  "hardBounced": 1000,
  "softBounced": 500,
  "opened": 5000,
  "clicked": 3000,
  "unsubscribed": 500,
  "spam": 200
}

Authorizations

​
X-Account-ApiKey
string
header
required

This api key can be used for all account level operations

Path Parameters

​
subaccount_id
integer
required

The ID of the subaccount to retrieve

Example:

11

Query Parameters

​
group
string
required

Group whose aggregated stats need to be retrieved

​
from
string<date>
required

The starting date for the aggregated stats

​
to
string<date>
required

The ending date for the aggregated stats (Note: from should be earlier than to and the date range should not exceed 366 days)

Response

200 - application/json

Aggregated email stats for the group within the specified date range

​
processed
integer

Number of emails accepted by SendPost API.

Example:

225

​
delivered
integer

Number of emails we were able to successfully deliver at SMTP without encountering any error

Example:

200

​
dropped
integer

Number of emails drop without attempting to deliver either because the email is invalid or email in in existing suppression list

Example:

10

​
hardBounced
integer

Number of emails where we got SMTP hard bounce error code by the recipient mail provider

Example:

10

​
softBounced
integer

Number of emails where we got temporary soft bounce error by the recipent mail provider. Soft bounced emails are retried upto 5 times over 24 hour period before marking them as hardBounced.

Example:

5

​
unsubscribed
integer

Number of email recipients who unsubscribed from receiving further emails

Example:

6

​
spam
integer

Number of email recipients who marked emails as spam

Example:

2

⌘I