Retrieve ARR

Examples

curl -X GET "https://api.chartmogul.com/v1/metrics/arr" \
     -u YOUR_API_KEY: \
     -d start-date=2015-01-01 \
     -d end-date=2015-11-24 \
     -d geo=US \
     -d interval=month

ChartMogul::Metrics.arr(start_date: '2015-01-01', end_date: '2015-11-24', geo: 'US', interval: 'month')

ChartMogul.Metrics.arr(config, {
   'start-date': '2015-01-01',
   'end-date': '2015-11-24',
   'interval': 'month',
   'geo': 'GB',
   'plans': 'PRO Plan'
}, function (err, res) {
   // asynchronously called
});

<?php

ChartMogul\Metrics::arr([
    "start-date" => "2015-01-01",
    "end-date" => "2015-11-24",
    "interval" => "month",
    "geo" => "GB",
    "plans" => "PRO Plan"
]);
?>

api.MetricsRetrieveARR(&cm.MetricsFilter{
        StartDate: "2016-01-01",
        EndDate:   "2016-03-12",
        Interval:  "month",
    Geo:             "GB",
    Plans:       "PRO Plan",
    })

chartmogul.Metrics.arr(
    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",
     "arr": 360000,
     "percentage-change": 0.0
    },
    {
     "date": "2015-02-28",
     "arr": 36600000,
     "percentage-change": 10066.67
    },
    {"...more...": "...entries..."}
  ],
  "summary":{
    "current": 4247999664,
    "previous": 4248256260,
    "percentage-change": -0.01
  }
}

#<ChartMogul::Metrics::ARRs:0x007fa4ec673778 
@entries=[
  #<ChartMogul::Metrics::ARR:0x007fa4ec673368 
  @date=2015-01-31, 
  @arr=360000,
  @percentage_change=0.0
  >, 
  #<ChartMogul::Metrics::ARR:0x007fa4ec672e18 
  @date=2015-02-28, 
  @arr=36600000,
  @percentage_change=10066.67
  >,
  <...more entries...>
], 
@summary=
  #<ChartMogul::Summary:0x007fa4ec64bde0 
  @current=305520000,
  @previous=305520000,
  @percentage_change=0.0
  >
>

{
  "entries":[
    {
      "date":"2015-01-31",
      "arr":360000,
      "percentage-change":0.0
    },
    {
      "date":"2015-02-28",
      "arr":36600000,
      "percentage-change":10066.67
    },
    {"...more...": "...entries..."}
  ],
  "summary":{
    "current":305520000,
    "previous":305520000,
    "percentage-change":0.0
  }
}

<?php

ChartMogul\Metrics\ARRs::__set_state(array(
    "entries" => 
  Doctrine\Common\Collections\ArrayCollection::__set_state(array(
     "elements" => 
    array (
      0 => 
      ChartMogul\Metrics\ARR::__set_state(array(
         "date" => "2015-01-31",
         "arr" => 360000,
         "percentage_change" => 0.0
      )),
      1 => ...
  ))),
   "summary" => 
  ChartMogul\Summary::__set_state(array(
     "current" => 305520000,
     "previous" => 305520000,
     "percentage_change" => 0.0
  )),
));
?>

(*chartmogul.ARRResult)(0xc0420b2f00)({
 Entries: ([]*chartmogul.ARRMetrics) (len=3) {
  (*chartmogul.ARRMetrics)(0xc0421da0a0)({
   Date: (string) (len=10) "2016-01-31",
   ARR: (float64) 49200,
   PercentageChange: (float64) 0
  }),
  (*chartmogul.ARRMetrics)(0xc0421da100)({
   Date: (string) (len=10) "2016-02-29",
   ARR: (float64) 49200,
   PercentageChange: (float64) 0
  }),
  (*chartmogul.ARRMetrics)(0xc0421da120)({
   Date: (string) (len=10) "2016-03-12",
   ARR: (float64) 49200,
   PercentageChange: (float64) 0
  })
 },
 Summary: (*chartmogul.Summary)(0xc0421da140)({
  Current: (float64) 49200,
  Previous: (float64) 49200,
  PercentageChange: (float64) 0
 })
})

Metrics(entries=[
    <Metrics{
        arr=49200.0,
        percentage_change=0.0,
        date=datetime.date(2016,
        1,
        31)}>,
    <Metrics{
        arr=49200.0,
        percentage_change=0.0,
        date=datetime.date(2016,
        2,
        29)}>,
    <Metrics{
        arr=49200.0,
        percentage_change=0.0,
        date=datetime.date(2016,
        3,
        12)}>],
summary=<Summary{
    current=49200.0,
    percentage_change=0.0,
    previous=49200.0}>)

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

date - the end date of each interval period.
arr - the Annual Run Rate as at the end of each interval period. This is in your account's selected currency and is an integer number of cents. Divide it by 100 to obtain the actual value.
percentage-change - The percentage change between the current ARR and ARR from the previous time interval. Will be set to 0.0 if this is the first entry in the response.

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