SEsequenzy
Analytics

Get aggregated email metrics

Changed on

Backward-compatible alias for GET /metrics. Returns aggregated email engagement metrics for the specified time period and supports the same emailType filter.

get/stats

Request

  • Base URL
    https://api.sequenzy.com/api/v1
  • URL
    https://api.sequenzy.com/api/v1/stats
  • Auth
    HTTP bearer

Query parameters

period'1h' | '24h' | '7d' | '30d' | '90d'

Sliding time window. Ignored when start/end are provided.

startstring date-time

Start of custom time range (ISO 8601). Must be used with end.

endstring date-time

End of custom time range (ISO 8601). Must be used with start. Max range: 90 days.

emailType'campaign' | 'transactional' | 'sequence'

Structural email type filter. Use transactional for Send API and transactional SMTP traffic.

mailboxProviderstring

Recipient mailbox provider filter (e.g. gmail, microsoft, yahoo, icloud). Scopes engagement metrics to recipients of that provider. Provider-filtered responses report replies as 0 (replies cannot be segmented per provider) and omit the commerce forecast.

includeMachineEngagementboolean

Include detected scanner, preview, and tracked asset open/click events.

Response

Success

successboolean
periodstring
emailType'campaign' | 'transactional' | 'sequence'
mailboxProviderstring

Echoed back when mailboxProvider is provided.

Example response

{
  "commerceForecast": {
    "modelVersion": "cohort-rfm-v1"
  }
}

Changes

  • db3873ca3d4dRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • f1d8cfd9faafRevision changes
    • warning

      added the new undefined enum value to the / response property for the response status