Get Analytics Time Series

Get an account-wide time series for a single metric, bucketed by day or week. Useful for charting mail performance trends. Missing buckets are filled with zeroes so the series is continuous across the full range.

Supported metrics:

sent — pieces mailed
delivered — pieces delivered
scans — QR/link scans (each point also includes secondary_value: total scans vs. unique properties)
open_rate — unique opens divided by pieces sent, as a percentage

query metricstringdefault: sent

One of sent, delivered, scans, open_rate.

query group_bystringdefault: day

Bucket size: day or week.

query daysintegerdefault: 30

Number of days back from today when no date range is given (1–365).

query start_datestring

Start of the date range (ISO). Overrides days when provided.

query end_datestring

End of the date range (ISO, defaults to now).

Request example

12curl "https://api.v2.dealmachine.com/v1/mail/analytics/timeseries?metric=sent&group_by=day&days=7" \
  -H "Authorization: Bearer dm_sk_live_xxx"

Response example

1234567891011121314151617{
  "data": {
    "metric": "sent",
    "group_by": "day",
    "start_date": "2026-06-03T00:00:00.000Z",
    "end_date": "2026-06-09T18:00:00.000Z",
    "points": [
      { "date": "2026-06-03", "value": 120 },
      { "date": "2026-06-04", "value": 0 },
      { "date": "2026-06-05", "value": 340 },
      { "date": "2026-06-06", "value": 210 },
      { "date": "2026-06-07", "value": 0 },
      { "date": "2026-06-08", "value": 95 },
      { "date": "2026-06-09", "value": 60 }
    ]
  }
}