Retrieve MRR Churn Rate

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 month
mrr-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.