v1

latestOpenAPI 3.0.32026-07-26737274.2 KB
Subscribers

List stats for a subscriber

Retrieve email stats for a specific subscriber: totals for sent, opened, clicked, and bounced emails, open and click rates, and recency signals (last_sent, last_opened, last_clicked, and sends since the last open/click). Filter the stats with the email_sent_after and/or email_sent_before query parameters to limit them to emails sent within a specific date range.

Data retention: Starting October 15, 2026, email stats (opens, clicks, sends, bounces, and unsubscribes) are available via the API for the last 5 years — email_sent_after/email_sent_before are clamped to that window, and dates outside it return a 400 error indicating the earliest available date. 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/subscribers/{subscriber_id}/stats

Path parameters

subscriber_idinteger required

Query parameters

email_sent_afterstring

Filter to stats for emails sent after this date (YYYY-MM-DD)/nNOTE: This will only include stats for emails sent in the last 5 years.

email_sent_beforestring

Filter to stats for emails sent before this date (YYYY-MM-DD)/nNote: Only data for events in the last 5 years will be included.

Response

Returns the stats for a subscriber