Read an email broadcast's stats, split-test variants and winner

An email broadcast's delivery, engagement and revenue numbers are now available at GET /api/v2/emails/broadcasts/{id}/stats: progress (audience, queued, processing, sent, failed), performance (opens, clicks, bounces, unsubscribes, spam complaints, each with a whole-percentage rate) and revenue (attributed total, order count, and revenue per recipient, per unique open and per unique click, as decimal strings in the workspace currency). The numbers cover the broadcast's own send window, returned as timerange, so the endpoint takes no timerange parameters; progress.total is null until the broadcast has started sending.

The broadcast record itself now tells you whether it was a subject-line split test and how it went. GET /api/v2/emails/broadcasts/{id} (and the list endpoint) return split_test, split_test_percentage, split_test_wait_time, and a variants array with each subject line, its preheadline, the share of the audience it was tested on, the opens counted during the test, and winner. winner is null while the test is still running and becomes true for exactly one variant once the wait time has passed and the rest of the audience has been sent the winning subject. A broadcast that is not a split test returns one variant, its main one; a broadcast sent before split tests existed returns none, so read the subject line from the broadcast's own subject when variants is empty.

Agent examples: report open rate and attributed revenue for every broadcast sent last month · report which subject line won each split test · flag split tests still waiting on a winner

Resources: Email Broadcast. Building with an AI agent? Point it at the Emails skill.