Analytics
Get Campaign Metrics
Retrieve engagement metrics for a specific campaign.
GET
Get Campaign Metrics
Returns engagement metrics (sends, deliveries, bounces, opens, clicks, unsubscribes) plus attributed conversions and revenue for a single campaign. Optionally filter by time period. Test sends are excluded from these performance metrics and attributed revenue by default so previews do not skew results, but they still count toward send usage and quota. Open and click metrics also exclude detected email-security scanners and tracked brand assets by default.
Without time filters, you get lifetime metrics for the campaign.
Useful to gauge initial engagement before the campaign matures.
GET /api/v1/campaigns/{campaignId}/stats is kept as a backward-compatible alias for this endpoint.
Path Parameters
The ID of the campaign.
Query Parameters
Sliding time window. One of:
1h, 24h, 7d, 30d, 90d. Ignored when
start and end are provided.Start of custom time range (ISO 8601). Must be used with
end.End of custom time range (ISO 8601). Must be used with
start. Max range: 90
days.Set to
true to include detected scanner, preview, and tracked asset
open/click events in engagement metrics.Response Fields
| Field | Type | Description |
|---|---|---|
sent | number | Emails sent in the period |
delivered | number | Emails delivered |
bounced | number | Emails that bounced |
opened | number | Unique opens |
clicked | number | Unique clicks |
unsubscribed | number | Unsubscribes |
deliveryRate | number | Delivery rate percentage |
bounceRate | number | Bounce rate percentage |
openRate | number | Open rate percentage |
clickRate | number | Click rate percentage |
unsubscribeRate | number | Unsubscribe rate percentage |
conversions | number | Goal conversions attributed to this campaign (last-touch, 24h window) |
revenueCents | number | Attributed revenue in cents from purchase events (saas.purchase and ecommerce.order_placed) |
Common Queries
How did our February newsletter perform?
How many opens in the first 24 hours after send?
Compare campaign performance over a specific week
Who opened or clicked in this campaign?
Use the Get Recipients endpoint with acampaignId filter to see individual recipient engagement:
Responses
Get Campaign Metrics