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: 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 is not available via the API or exports; creators can contact Kit support, though retrieval is not guaranteed. See Email data retention for the full policy.
Request
- Base URLhttps://api.kit.com
- URLhttps://api.kit.com/v4/subscribers/{subscriber_id}/stats
- Auth
- API key in header X-Kit-Api-Key
- or OAuth 2Authorization code: https://api.kit.com/v4/oauth/authorizeToken URL: https://api.kit.com/v4/oauth/token
Path parameters
Query parameters
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.
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
Changes
No recorded changes to this operation across all 2 revisions of this API.