Stats
Retrieve churn statistics and recovery metrics for a project.Get Project Stats
Example Request
Example Response
Response Fields
integer
Total number of churn events created for this project across all time.
integer
Number of churn events where the customer reactivated or payment succeeded.
integer
Number of churn events where the recovery window expired without reactivation.
integer
Number of churn events currently being processed (status:
new, processing, variants_generated, or email_sent).float
Percentage of resolved events that were recovered. Calculated as
recovered / (recovered + lost) * 100. Returns 0 if no events have been resolved.integer
Total MRR at risk across all churn events, in cents. Sum of
mrr from all events.integer
Total MRR recovered, in cents. Sum of
mrr from recovered events.Understanding the Metrics
Recovery Rate
Recovery Rate
The recovery rate only considers resolved events (recovered + lost). Events still in processing are excluded to avoid skewing the metric. A healthy recovery rate for SaaS companies is typically 10-30%.
MRR Calculation
MRR Calculation
MRR values are stored in cents to avoid floating-point issues. To display in dollars, divide by 100. Events without an
mrr value are excluded from MRR calculations but still count toward event totals.Processing Events
Processing Events
Processing events include all active states:
new, processing, variants_generated, and email_sent. These are events that still have a chance of being recovered.