Get Notification Template Metrics
Fetch the delivery funnel for one Notification Template as a time series — sent, delivered, opened, clicked, errors, and undeliverable — broken out per provider and channel inside each bucket. Sum the entries in a bucket for its totals; there is no bucket-level total.
Choose the window absolutely with start and end, or relatively with lookback (an ISO 8601 duration). start and end take precedence when both are supplied, and a request carrying neither defaults to lookback=P30D. The window is snapped outwards onto the granularity grid so every bucket it overlaps is returned whole, and the snapped boundaries come back as start and end — align a chart on those rather than on what was requested. Every boundary is UTC; there is no timezone support.
Every bucket in the window is returned, including the quiet ones, whose data array is empty, so a series is directly plottable with no gap filling client-side. An unknown template id returns 200 with an all-empty series rather than 404, and messages sent without a Notification Template never appear here.
Available in the US region only.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
The Notification Template to report on — its ID (nt_ prefix) or an alias. Must not contain commas or whitespace.
1Query Parameters
The size of each bucket in the series. Defaults to DAY. WEEK buckets start on Sunday. A fine granularity caps the window it can cover: HOUR spans at most 7 days and DAY at most 90 days, and a wider window returns 400 — request a coarser granularity instead. WEEK and MONTH are uncapped, subject to the 1000-bucket limit on a single response.
HOUR, DAY, WEEK, MONTH The length of the window, counted back from now, as an ISO 8601 duration (P30D, P12W, PT12H). Defaults to P30D, and is ignored when start and end are supplied. A malformed or non-positive duration returns 400.
The inclusive start of the window, as an ISO 8601 timestamp with an offset (2026-04-01T00:00:00Z). Must be supplied together with end and be earlier than it; either one alone returns 400.
The end of the window, as an ISO 8601 timestamp with an offset. Must be supplied together with start. An end in the future is accepted and not clamped — the trailing buckets come back empty.
Response
The delivery funnel for the Notification Template, bucketed over the resolved window.
The template the series describes, echoed from the request.
Bucket size the series was built at.
HOUR, DAY, WEEK, MONTH Inclusive start of the window actually queried, floored onto the granularity grid. Second-precision UTC.
End of the window actually queried, ceiled onto the granularity grid. Second-precision UTC.
One entry per bucket between start and end, oldest first, including buckets with no activity.