Transactional — Stats¶

Recent event collection for a transactional send.

Endpoint¶

Method	URL
`GET`	`/transactional/<transactional>/stats`

GET¶

Parameter	Type	Description
`event`	string	Query parameter. Optional. Event type to retrieve. Defaults to `delivered`.
`start`	timestamp	Optional. Lower bound for reported events. Defaults to 24h ago. Accepts Unix timestamp (int), ISO 8601 datetime, or ISO 8601 date (interpreted as 00:00 of that day).

Event values¶

Value	Description	Available for SMTP?
`submitted`	Submitted messages	Yes
`delivered`	Delivered messages	Yes
`bounced`	Bounced messages	Yes
`opened`	Opened messages	No
`clicked`	Any link clicked	No
`unsubscribed`	Caused unsubscription	No
`link_clicked`	Specific link events	No

Returns: An event list (events) containing a timestamp and destination contact per entry.

Example:

curl -u "username:api_key" -H "Accept: application/json" \
  "https://app.duo.pt/transactional/{transactional_id}/stats?event=delivered"

Response:

{
  "success": true,
  "data": {
    "startTimestamp": null,
    "transactional": {
      "id": 1,
      "owner": 1,
      "name": "Order Confirmation",
      "list": 1,
      "domain": 1,
      "smtp_submission": false,
      "send_dsn": false
    },
    "events": [],
    "page": 1,
    "pageSize": 10,
    "pageCount": 0
  }
}