get https://api.chartmogul.com/v1/metrics/mrr-churn-rate
Retrieves the Net MRR Churn Rate, for the specified time period.
Examples
curl -X GET "https://api.chartmogul.com/v1/metrics/mrr-churn-rate" \
-u YOUR_API_KEY: \
-d start-date=2015-01-01 \
-d end-date=2015-11-01
ChartMogul::Metrics.mrr_churn_rate(start_date: '2015-01-01', end_date: '2015-11-01')
ChartMogul.Metrics.mrrChurnRate(config, {
'start-date': '2015-01-01',
'end-date': '2015-11-01'
}, function (err, res) {
// asynchronously called
});
<?php
ChartMogul\Metrics::mrrChurnRate([
"start-date" => "2015-01-01",
"end-date" => "2015-11-01",
]);
?>
api.MetricsRetrieveMRRChurnRate(&cm.MetricsFilter{
StartDate: "2016-01-01",
EndDate: "2016-03-12",
Interval: "month",
Geo: "GB",
Plans: "PRO Plan",
})
chartmogul.Metrics.mrr_churn_rate(
config,
start_date="2016-01-01",
end_date="2016-03-12",
interval="month",
geo="GB",
plans="PRO Plan")
Result Format
{
"entries":[
{
"date":"2015-01-31",
"mrr-churn-rate":-300.0
},
{
"date":"2015-02-28",
"mrr-churn-rate":-0.0
},
{"...more...": "...entries..."}
],
"summary":{
"current":0,
"previous":0,
"percentage-change":0.0
}
}
#<ChartMogul::Metrics::MrrChurnRates:0x007faf03caacd8
@entries=[
#<ChartMogul::Metrics::MrrChurnRate:0x007faf03caa990
@date=2015-01-31,
@mrr_churn_rate=-300.00
>,
#<ChartMogul::Metrics::MrrChurnRate:0x007faf03caa3a0
@date=2015-02-28,
@mrr_churn_rate=-0.0
>,
<...more entries...>
],
@summary=
#<ChartMogul::Summary:0x007faf03ca3dc0
@current=0,
@previous=0,
@percentage_change=0.0
>
>
{
"entries":[
{
"date":"2015-01-31",
"mrr-churn-rate":-300.0
},
{
"date":"2015-02-28",
"mrr-churn-rate":-0.0
},
{"...more...": "...entries..."}
],
"summary":{
"current":0,
"previous":0,
"percentage-change":0.0
}
}
<?php
ChartMogul\Metrics\MRRChurnRates::__set_state(array(
"entries" =>
Doctrine\Common\Collections\ArrayCollection::__set_state(array(
"elements" =>
array (
0 =>
ChartMogul\Metrics\MRRChurnRate::__set_state(array(
"date" => "2015-01-31",
"mrr_churn_rate" => -300.0,
)),
1 =>
ChartMogul\Metrics\MRRChurnRate::__set_state(array(
"date" => "2015-02-28",
"mrr_churn_rate" => -0.0,
)),
2 => ...
))),
"summary" =>
ChartMogul\Summary::__set_state(array(
"current" => 0,
"previous" => 0,
"percentage_change" => 0.0,
)),
));
?>
(*chartmogul.MRRChurnRateResult)(0xc0420b2f00)({
Entries: ([]*chartmogul.MRRChurnRateMetrics) (len=3) {
(*chartmogul.MRRChurnRateMetrics)(0xc04210e760)({
Date: (string) (len=10) "2016-01-31",
MRRChurnRate: (float64) 66.67
}),
(*chartmogul.MRRChurnRateMetrics)(0xc04210e7c0)({
Date: (string) (len=10) "2016-02-29",
MRRChurnRate: (float64) 0
}),
(*chartmogul.MRRChurnRateMetrics)(0xc04210e7e0)({
Date: (string) (len=10) "2016-03-12",
MRRChurnRate: (float64) 0
})
},
Summary: (*chartmogul.Summary)(0xc04210e800)({
Current: (float64) 0,
Previous: (float64) 0,
PercentageChange: (float64) 0
})
})
Metrics(entries=[
<Metrics{
date=datetime.date(2016, 1, 31),
mrr_churn_rate=66.67}>,
<Metrics{
date=datetime.date(2016, 2, 29),
mrr_churn_rate=0.0}>,
<Metrics{
date=datetime.date(2016, 3, 12),
mrr_churn_rate=0.0}>],
summary=<Summary{
current=0.0,
percentage_change=0.0,
previous=0.0}>)
In the response, the entries
key contains an object for each month, with the following data:
date
- The date of the end of the monthmrr-churn-rate
- The Net MRR churn rate at the end of that month, expressed as a percentage.
Note that MRR Churn Rate can be both negative, and larger than 100% - in this case, a negative churn rate of -300.0% means that the MRR actually quadrupled during that period.
Normal values will typically be between -10% and +10%, though that depends, naturally, on what your customers are actually doing.
The summary
key contains the current Net MRR Churn Rate value, the value a month ago, and the percentage change between these two measures.