Sign in

v1

latestSwagger 2.0MIT2026-07-17233380637.0 KB
Transactional emails

Get your transactional email activity aggregated over a period of time

This endpoint will show the aggregated stats for past 90 days by default if startDate and endDate OR days is not passed. The date range can not exceed 90 days

get/smtp/statistics/aggregatedReport

Query parameters

startDatestring

Mandatory if endDate is used. Starting date of the report (YYYY-MM-DD). Must be lower than equal to endDate

endDatestring

Mandatory if startDate is used. Ending date of the report (YYYY-MM-DD). Must be greater than equal to startDate

daysinteger

Number of days in the past including today (positive integer). Not compatible with 'startDate' and 'endDate'

tagstring

Tag of the emails

Response

Aggregated report informations

rangestring

Time frame of the report

requestsinteger

Number of requests for the timeframe

deliveredinteger

Number of delivered emails for the timeframe

hardBouncesinteger

Number of hardbounces for the timeframe

softBouncesinteger

Number of softbounces for the timeframe

clicksinteger

Number of clicks for the timeframe

uniqueClicksinteger

Number of unique clicks for the timeframe

opensinteger

Number of openings for the timeframe

uniqueOpensinteger

Number of unique openings for the timeframe

spamReportsinteger

Number of complaint (spam report) for the timeframe

blockedinteger

Number of blocked contact emails for the timeframe

invalidinteger

Number of invalid emails for the timeframe

unsubscribedinteger

Number of unsubscribed emails for the timeframe

Example response

{
  "range": "2016-09-08|2017-04-06",
  "requests": 263,
  "delivered": 249,
  "hardBounces": 1,
  "softBounces": 4,
  "clicks": 12,
  "uniqueClicks": 8,
  "opens": 47,
  "uniqueOpens": 37,
  "blocked": 2
}