Sign in

v1

latestOpenAPI 3.0.32026-07-26737274.2 KB
Broadcasts

Get stats for a list of broadcasts

Returns delivery and engagement stats — recipients, opens, clicks, unsubscribes, and their corresponding rates — for a page of broadcasts in a single request, avoiding a call per broadcast. Narrow the results with the status filter and the sent_after/sent_before timestamps; results are cursor-paginated with up to 1000 broadcasts per page (default 500).

For a single broadcast, use Get stats for a broadcast.

Data retention: Starting October 15, 2026, email stats (opens, clicks, sends, bounces, and unsubscribes) are available via the API for the last 5 years — broadcasts sent before that window are omitted from this list. Older data is archived and can no longer be retrieved via the API; creators can contact Kit support to request an export of their archived data. See Email data retention for the full policy.

get/v4/broadcasts/stats

Query parameters

{"stackTrail":"paths:/v4/broadcasts/stats:get:parameters:0:schema","oasType":"schema","type":"unknown","nullable":true}

To fetch next page of results, use ?after=<end_cursor>

{"stackTrail":"paths:/v4/broadcasts/stats:get:parameters:1:schema","oasType":"schema","type":"unknown","nullable":true}

To fetch previous page of results, use ?before=<start_cursor>

include_total_countboolean

Set to true to include the total_count in the response. This option can cause slow responses; if paging through results, request it only on the first page and reuse the value for subsequent pages.

{"stackTrail":"paths:/v4/broadcasts/stats:get:parameters:3:schema","oasType":"schema","type":"unknown","nullable":true}

Number of results per page. Default 500, maximum 1000.

{"stackTrail":"paths:/v4/broadcasts/stats:get:parameters:4:schema","oasType":"schema","type":"unknown","nullable":true}
{"stackTrail":"paths:/v4/broadcasts/stats:get:parameters:5:schema","oasType":"schema","type":"unknown","nullable":true}
status'draft' | 'scheduled' | 'sending' | 'completed' | 'aborted'

Filter broadcasts by lifecycle status. One of: draft, scheduled, sending, completed, aborted.

Response

Returns stats for all broadcasts on the account