Retrieve MRR

Retrieves the Monthly Recurring Revenue (MRR), for the specified time period.

Examples
curl -X GET "https://api.chartmogul.com/v1/metrics/mrr" \
     -u YOUR_API_KEY: \
     -d start-date=2015-01-01 \
     -d end-date=2015-11-01 \
     -d interval=week
ChartMogul::Metrics.mrr(start_date: '2015-01-01', end_date: '2015-11-01', interval: 'week')
ChartMogul.Metrics.mrr(config, {
   'start-date': '2015-01-01',
   'end-date': '2015-11-01',
   'interval': 'week'
}, function (err, res) {
   // asynchronously called
});
<?php

ChartMogul\Metrics::mrr([
    "start-date" => "2015-01-01",
    "end-date" => "2015-11-01",
    "interval" => "month"
]);
?>
api.MetricsRetrieveMRR(&cm.MetricsFilter{
        StartDate: "2016-01-01",
        EndDate:   "2016-03-12",
        Interval:  "month",
    Geo:             "GB",
    Plans:       "PRO Plan",
    })
chartmogul.Metrics.mrr(
    config,
    start_date="2016-01-01",
    end_date="2016-03-12",
    interval="month",
      geo="GB",
        plans="PRO Plan")
Result Format
{
  "entries":[
    {
      "date":"2015-01-03",
      "mrr":30000,
      "mrr-new-business":10000,
      "mrr-expansion":15000,
      "mrr-contraction":0,
      "mrr-churn":0,
      "mrr-reactivation":0
    },
    {
      "date":"2015-01-10",
      "mrr":30000,
      "mrr-new-business":0,
      "mrr-expansion":0,
      "mrr-contraction":0,
      "mrr-churn":0,
      "mrr-reactivation":0
    },
    {"...more...": "...entries..."}
  ],
  "summary":{
    "current":43145000,
    "previous":43145000,
    "percentage-change":0.0
  }
}
#<ChartMogul::Metrics::MRRs:0x007fa4ed85e0f0 
@entries=[
  #<ChartMogul::Metrics::MRR:0x007fa4ed85cf48 
  @date=2015-01-03,
  @mrr=30000,
  @mrr_new_business=10000,
  @mrr_expansion=15000,
  @mrr_contraction=0,
  @mrr_churn=0,
  @mrr_reactivation=0
  >, 
  #<ChartMogul::Metrics::MRR:0x007fa4ed854a50 
  @date=2015-01-10,
  @mrr=30000,
  @mrr_new_business=0,
  @mrr_expansion=0,
  @mrr_contraction=0,
  @mrr_churn=0,
  @mrr_reactivation=0
  >,
  <...more entries...>
],
@summary=
  #<ChartMogul::Summary:0x007fa4ec07dda0
  @current=43145000,
  @previous=43145000,
  @percentage_change=0.0
>
>
{ 
  "entries":[
    { 
      "date": "2015-01-03",
      "mrr": 2083,
      "mrr-new-business": 2083,
      "mrr-expansion": 0,
      "mrr-contraction": 0,
      "mrr-churn": 0,
      "mrr-reactivation": 0
    },
    {
      "date": "2015-01-10",
      "mrr": 15166,
      "mrr-new-business": 13083,
      "mrr-expansion": 0,
      "mrr-contraction": 0,
      "mrr-churn": 0,
      "mrr-reactivation": 0
    },
    {
      "date": "2015-01-17",
      "mrr": 26749,
      "mrr-new-business": 11583,
      "mrr-expansion": 0,
      "mrr-contraction": 0,
      "mrr-churn": 0,
      "mrr-reactivation": 0
    },
    {"...more...": "...entries..."}
  ],
  "summary": {
    "current": 1131228,
    "previous": 1211228,
    "percentage-change": -7
  }
}
<?php

ChartMogul\Metrics\MRRs::__set_state(array(
   "entries" => 
  Doctrine\Common\Collections\ArrayCollection::__set_state(array(
     "elements" => 
    array (
      0 => 
      ChartMogul\Metrics\MRR::__set_state(array(
         "date" => "2015-01-03",
         "mrr" => 2083,
         "mrr_new_business" => 2083,
         "mrr_expansion" => 0,
         "mrr_contraction" => 0,
         "mrr_churn" => 0,
         "mrr_reactivation" => 0,
      )),
      1 => ...
   ))),
   "summary" => 
  ChartMogul\Summary::__set_state(array(
     "current" => 1131228,
     "previous" => 1211228,
     "percentage_change" => -7,
  )),
));
?>
(*chartmogul.MRRResult)(0xc0420b2f00)({
 Entries: ([]*chartmogul.MRRMetrics) (len=3) {
  (*chartmogul.MRRMetrics)(0xc0420ca180)({
   Date: (string) (len=10) "2016-01-31",
   MRR: (float64) 4100,
   MRRNewBusiness: (float64) 0,
   MRRExpansion: (float64) 0,
   MRRContraction: (float64) -8200,
   MRRChurn: (float64) 0,
   MRRReactivation: (float64) 0
  }),
  (*chartmogul.MRRMetrics)(0xc0420ca1c0)({
   Date: (string) (len=10) "2016-02-29",
   MRR: (float64) 4100,
   MRRNewBusiness: (float64) 0,
   MRRExpansion: (float64) 0,
   MRRContraction: (float64) 0,
   MRRChurn: (float64) 0,
   MRRReactivation: (float64) 0
  }),
  (*chartmogul.MRRMetrics)(0xc0420ca200)({
   Date: (string) (len=10) "2016-03-12",
   MRR: (float64) 4100,
   MRRNewBusiness: (float64) 0,
   MRRExpansion: (float64) 0,
   MRRContraction: (float64) 0,
   MRRChurn: (float64) 0,
   MRRReactivation: (float64) 0
  })
 },
 Summary: (*chartmogul.Summary)(0xc0420c6160)({
  Current: (float64) 4100,
  Previous: (float64) 4100,
  PercentageChange: (float64) 0
 })
})
Metrics(entries=[
    <Metrics{
        date=datetime.date(2016, 1, 31),
        mrr=4100.0,
        mrr_churn=0.0,
        mrr_contraction=-8200.0,
        mrr_expansion=0.0,
        mrr_new_business=0.0,
        mrr_reactivation=0.0}>,
    <Metrics{
        date=datetime.date(2016, 2, 29),
        mrr=4100.0,
        mrr_churn=0.0,
        mrr_contraction=0.0,
        mrr_expansion=0.0,
        mrr_new_business=0.0,
        mrr_reactivation=0.0}>,
    <Metrics{
        date=datetime.date(2016, 3, 12),
        mrr=4100.0,
        mrr_churn=0.0,
        mrr_contraction=0.0,
        mrr_expansion=0.0,
        mrr_new_business=0.0,
        mrr_reactivation=0.0}>],
summary=<Summary{
    current=4100.0,
    percentage_change=0.0,
    previous=4100.0}>)

In the response, the entries key contains an object for each interval, with the following data:

  • date - The date of the end of the interval.
  • mrr - The Monthly Recurring Revenue as at the end of the interval.
  • mrr-new-business - New MRR during the interval from new customers.
  • mrr-expansion - New MRR during the interval from existing customers (e.g. plan upgrades).
  • mrr-contraction - Decrease in MRR during the interval, excluding cancellations.
  • mrr-churn - Total decrease in MRR from customers who cancelled a subscription.
  • mrr-reactivation - Increase in MRR from customers who previously cancelled a subscription.

All amounts are given in the selected currency of your account, and are an integer number of cents. Divide by 100 to obtain the actual value.

The summary key contains the current MRR value, the value 30 days ago, and the percentage change between these two measures.

Language
Authentication
Basic
base64
: